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Package Itfdex 

Other Packages 

• package .default 

• package ecardfile.appl 

• package ecardiile.dbappl 

• package multiserwapplsen-let 

• package multisen-.dbmgr 

■ • package multisen .sessionmgr 

• package multisenMitil 
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package.default 

Class litdeK 

• LoginSen-let 

• SearchSenlet 



Class LoginServlet 



Ob j ect 

I 

+ GenericServlet 

■ I 

+ — HttpServlet 

I 

+ ApplServlet 

I 

+ LoginServlet 

public class LoginServlet 

extends ApplSenlet ' 
Used to override the getApplicationlnterface method defined in ApplServlet. This 
method provides the link between the generic components of package 
multiserv.applserv'let and the application specific fimctionality. 

CofisPrMCPor 

^ LoginSenlet Q 

MePffod IrtdeK 

# geL\pplicntionInterface () 

Overrides the getApplicationlnterface method defined in class 

ApplServlet. 
•init(ServletConf^ 

Called when the servlet first gets loaded. 

CotisPruePors 

ii^LoginSendet ~ 

public LoginServlet (•) 

M^P^ods 

• get^plicationlnterface 

public multiserv.applservlet .Applicationlnterface 
getApplicationlnterface ( ) 

Overrides the getApplicationlnterface method defined in class 

ApplServlet. This method must return an instance of the application 

specific class which implements Applicationlnterface. 

Overrides: 

getApplicationlnterface in class ApplSen^let 



init 



public void init (ServletConf ig config) throws ServletException 
Called when the servlet first gets loaded. Do our application specific 
servlet initialization here after calling initQ in ApplServleL 
Paiameteis: 

config - servlet configuration infonnation. 
Throws: ServletException 

a problem occurred durii^ the initialization of the servlet. 
Overrides: 

init in class ApplSen^let 



Cfass SearchServtet 



Object 

I 

+ GenericServlet 

I 

+ HttpServlet 

I 

+ ApplServlet 

I 

+ SearchServlet 



public class SearchSeniet 
extends ApplSen-lei 

Used to override the getApplicationlnterface method defined in ApplServlet. This 
method provides the link between the generic components of package 
multiserv.applservlet and the application specific functionality. 

CortsPriiePor iMdey^ 

^SenrchServletO 

• geL\pplicationI nterface () 

Overrides the getApplicationlnterface method defined in class 

ApplServlet. 
•init(ServletConf^ 

Called \\dien the servlet first gets loaded 

CoitsPmepors 

^SearchSer\iet 

public SearchServlet ( ) 

M^P^ods 

9 getApplicationlnterface 

public multiserv.applservlet .Applicationlnterf ace 
getApplicationlnterface ( ) 

Overrides the getApplicationlnterface method defined in class 

ApplServlet This method must return an instance of the application 

specific class which implements Applicationlnterface. 

Ovenides: 
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. geuApplicationlntertac'e in class ApplSendet 

init 

public void init (ServletConf ig config) throws ServletException 
Called when the servlet first gets loaded Do our application specific 
seivlet initialization here after calling initQ in AppIServlet. 
Parameters: 

config - servlet configuration information. 
Throws: Sen^letException 

a problem occurred during the initialization of the servleL 
Overrides: 

init in class ApplServ'let 



10 



package ecardfile^ppl 

inperface ludeyi, 

• CommonConfig 

Class /f/dsK 

• ComrnorL'\pplicationInterface 

• EcardNotitier 

• LoginApplicationlntertace 

• Search.\pplicationImerface 



Interface ecardfile.appl.CommonConfig 

public abstraa interface CommonConfig 

Defines the common constants used by the application 

yariakle iMdeyi, 

.ADDLISTTAG 

>ADDR£SSID_TAG 

. .\DDUSE RCONFIRM_TAG 

>ADDUSER_TAG 

. ALTFIRSTNAME_COL 

. ALTFIRSTNAMETAG 

. ALTFI RSTN AME TOKE N 

. BANNER_TOKEN 

> BUS1NE SSCOMME NT TOKE N 

. BLTTONTAG 

> G\NCEL_TAG 

> CARDEXTR.\ 

.CARDIDTAG 

>C\RDID_TOKEN 

.GATE GORYTOKE N 

. CHANGE 

.CH.ANGEDETAILS TAG 



•CH.\NGEVCHEREAMI TAG 


•COMPANYNAME 


COL 


•companyn.\me' 


ENC TOKEN 


•COMPANYNAME" 


TAG 



>COMPANYNAME_TOKEN 

>CONFIRM_TAG 

.CONTACTCOL 

• CREATE I D_T AG 

•DATE OFE NTRYT AG 

• DATE OFE NTRYTOKE N 

• DE LETE USE RCONFIRMTAG 

•DELETE USE R_T AG 

• DELETE_TAG 

• DISPLAY 

• DISPLAYFMTTAG 
• DISPLAYFMTTOKEN 
• DISPLAYLISTTAG 
» DISPLAY_PAGE_TAG 
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> DOADD\\HE R£_TAG 
,DQCHANGE DETAI LS_TAG 
.DOCHANGE WHE RE TAG 
.DODOWNLOADCARD TAG 
. DODOTOLOADPLIST TAG 
.DODOm'LO.ADSINGLE TAG 
.DOSEARCH TAG 
. DOLT^DATE PLI ST TAG 
,DO\\^LOADFMT TAG 
,DOTOLOADID_TAG 
, DO\t-NLO.\DSINGLE_TAG 
> DO\\'NLO.\D_TAG 
> EC\RD1D_TAG 
>EC\RDID_TOKEN 
. EDITPRIVACYTAG 
> EMAILALrrH_COL 
> EM.\ILALTH_TAG 
> EMAILAUTH_TOKEN 
> EM.\ILID TAG 
. E P.ASSWORDCONF TAG 
. E PASSWORD TAG 
. EXPIR'iT)ATE COL 
.FIND PASSWORD TAG 
. FIRSTN.\ME COL 
. FIRSTN.^ME E NC TOKE N 
. FIRSTNAME TAG 
. FIRSTNAMETOKEN 
> FMT_TAG 

> FLT-LNAME_TOKEN 
•HTML 

. 1 D_RE W^TE _TOKE N 
> ID TOKEN 
.JOBTITLETOKEN 
> LASTNAME COL 
> LASTNAME ENC TOKEN 
.LASTNAME TAG 
. L ASTN AME TOKE N 
.LC PRIVAC^TREFIX 
>LISTITEMS TOKEN 
•LOGIN SERVLET TOKEN 
.MASK COL 
.MASK TOKEN 
. MIDDLE NAME COL 
.MIDDLE NAME TAG 
.MIDDLENAMETOKEN 
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. MSGLISTTOKEN 

. NEWUSERTAG 

>OK TAG 

. ONETIME TAG 

.PAGETAG 

.PAGETOKEN 

. PASSWORD COL 

.PASSWORD TOKEN 

.PDAPAGE TAG 

. PE RSONALLISTIDCOL 

.PE RSON ALL ISTITE MSTOKE N 

.PHONEIDTAG 

. PRJVACYTREFIX 

. PVTALTFIRSTNAME TOKEN 

.PVTBUSINE SSCOMME NTTOKE N 

. PVTCOMPANYNAME TOKE N 

. P\TCONTACr COL 

. P\TFIRSTNAME_TOKEN 

. P\TJOBTITLE TOKEN 

. PWLASTNAMETOKEN 

.PVTLISTIDCOL 

. PVTLISTID TOKEN 

.PVTMIDDLE NAME TOKE N 

.PVTSUFFIXTOKEN 

.PVTTITLE TOKEN 

.P\T WE B PAGE URLTOKE N 

.RO>XaD TAG 

.SEARCHIDTAG 

.SEARCHLISTITEMSTOKEN 

. SEARCHNAMETAG 

. SE ARCH_SE R\T.ET_TOKE N 

. SEARCH TAG 

. SITE_ADDRESS_TOKEN 

.SOUNDEXTAG 

.SUFFIX_COL 

.SUFFIX TOKEN 

. TEMPLATE 

.TITLECOL 

. TITLE TOKEN 

.UPDATE TAG 

.USERINFOID TAG 

. USERSID COL 

. USERSIDTOKEN 

.WEBPAGE URL ENC TOKEN 

.WEB PAGE URL TOKEN 
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•WHEREAMl 
.WHERE AMI TAG 

•miL 

» monthNames 

Static anay with the names of the months for fomiattir^ dates 

yariapUs 

•ADDLIST_TAG 

piablic static final java. lang. String ADDLIST_TAG 
•ADDRESSID_TAG 

public static final java. lang. String ADDRESSID_TAG 
•ADDUSERCONFIRMTAG 

public static final java. lang. String 

ADDUSERCONFIRM_TAG 

•ADDUSER TAG 

public static final java. lang. String ADDUSER_TAG 
•ALTFIRSTNAME_COL 

piiblic static final j ava . lang . String ALTFIRSTNAME_COL 
•ALTFIRSTNAME_TAG 

public static. final java. lang. String ALTFIRSTNAME_TAG 
•ALTFIRSTNAME_TOKEN 

public static final j ava . lang . String 

ALTFIRSTNAME_TOKEN 

•BANNERTOKEN 

public static final java. lang. String BANNER_TOKEN 
•BUSINESSCOMMENT_TOKEN 

public static final java. lang. String 
BUS INESSCOMMENT_TOKEN 

•BUrTON_TAG 

public static final java. lang. String BUTTON_TAG 
•CANCEL_TAG 

p\iblic static final java. lang. String CANCEL_TAG 
CARDEXTRA 
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public static final ' short CARDEXTRA 
CARDIDTAG 



pi±ilic static final java. lang. String CARDID_TAG 
•CARDIDTOKEN 

piiblic static final java. lang. String CARDID_TOKEN 
•CATEGORY_TOKEN 

px±)lic static final j ava . lang . String CATEGORY_TOKEN 
•CHANGE 



piiblic static final short CHANGE . 
•CHANGEDETAILS_TAG 

public static final j ava . lang . String 

CHANGEDETAILS_TAG 

•CHANGE WHE RE AMITAG 

public static final j ava . lang . String 

CHANGEWHEREAMI_TAG 

•COMPANYNAME_COL 

public static final j ava . lang . String COMPANYNAME_COL 
•COMPANYNAME_ENC_TOKEN 

public static final java. lang. String 
COMPANYNAME_ENC_TOKEN 
•COMPANYNAME TAG 

public static final j ava . lang . String COMPANYNAME_TAG 
•COMPANYNAME TOKEN 

public static final java. lang. String 

COMPANYNAME_TOKEN 

•CONFIRM_TAG 

public static final java. lang. String CONFIRM_TAG 
•CONTACr_COL 

public static final java. lang. String CONTACT_COL 
•CREATE IDTAG 

public static final java. lang. String CREATEID_TAG 
•DATEOFENTRY TAG 
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piablic static final java. lang. String DATEOFENTRY_TAG 
DATEOFENTRY TOKEN 

piiblic static final java. lang. String 

DATEOFENTRY_TOKEN 

•DELETEUSERCONFIRM_TAG 

public static final java. lang. String 

DELETEUSERCONFIRM_TAG 

• DELETEUSERTAG 

pioblic static final java. lang. String DELETEUSER_TAG 
•DELETE TAG 



public static final java. lang. String DELETE_TAG 
•DISPLAY 

piiblic static final short DISPLAY 
•DISPLAYFMTTAG 

public static final java. lang. String DISPLAYFMT_TAG 
•DISPLAYFMTTOKEN 

public static final java. lang. String DISPIiAYFMT_TOKEN 
•DISPLAYLIST TAG 

public static final java. lang. String DISPLAYLIST_TAG 
•DISPLAY PAGE_TAG 

piiblic static final java. lang. String DISPLAY_PAGE_TAG 
•DOADDWHERE TAG 

public static final java. lang. String DOADDWHERE_TAG 
•DOCHANGEDETAILS_TAG 

piablic static final java. lang. String 

DOCHANGEDETAILS_TAG 

•DOCHANGEWHERETAG 

public static final java. lang. String 
DOCHANGEWHERE_TAG 
•DODOWNLOADCARD TAG 
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public static final java. lang. String 
DODOWNLOADCARD_TAG 

DODOWNLOADPLISTJFAG 

piablic static final java. lang. String 

DODOWNLOADPLI ST_TAG 

• DODOWNLOADSINGLE_TAG 

piiblic static final java, lang. String 
DODOWNLOADS INGLE_TAG 
•DOSEARCH_TAG 

public static final java. lang. String DOSEARCH_TAG 
•DOUPDATEPLIST_TAG 

public static final java. lang. String 
DOUPDATEPLIST_TAG 
^3 •DOWNLOADFMTTAG 

■Jj 

m public static final java. lang. String DOWNLOADFMT_TAG 

O •DOWNLOADIEMTAG 

nJ public static final java. lang. String DOWNLOAD I D_TAG 

•DOWNLOADSINGLE_TAG 

a ? ii 

^ public static final 

^ DOWNLOADS INGLE_TAG 

J •DOWNLQADJTAG 

~ public static final 

y •ECARDID TAG 

pi±>lic static final 
•ECARDID_TOKEN 

public static final 
•EDITPRIVACYTAG 

public static final 
•EMAILAUTH_COL 

public static final 
•EMAILAUTHTAG 

p\iblic static final 



j ava - lang . String 

j ava . lang . String DOWNLOAD_TAG 
j ava . rang . String ECARDID_TAG 
j ava . lang . String ECARDID_TOKEN 
j ava . lang . String EDITPRIVACY_TAG 
j ava . lang . String EMAIIiAUTH_COL 
j ava . lang . String EiyiAIIiAUTH_TAG 
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• EMAILAUrH_TOKEN 

public static final java. lang. String EMAILAUTH_TOKEN 
•EMAILID_TAG 

p\iblic static final java, lang. String EMAILID_TAG 
•EPASSWORDCX)NF_TAG 

pxablic static final java. lang. String 
EPAS SWORDCONF_TAG 
•EPASSWORD_TAG 

public static final java. lang. String EPASSWORD_TAG 
•EXPIRYDATE COL 



public static final java. lang. String EXPIRYDATE_COL 

• FIND_PASS WORD_TAG 

public static final java. lang. String 

FIND_PASSWORD_TAG 

•FIRSTNAME_COL 

public static final java. lang. String FIRSTNAME_COL 

• FIRSTNAME_ENC_TOKEN 

piablic static. final java. lang. String 

FIRSTNAME_ENC_TOKEN 

•FIRSTNAME_TAG 

pviblic static final java. lang. String FIRSTNAME_TAG 

• FIRSTNAME_TOKEN 

piablic static final java. lang. String FIRSTNAMETOKEN 
•FMT_TAG 

public static final java. lang. String FMT_TAG 
•FULLNAME TOKEN 



public static final java. lang. String FULLNAME TOKEN 
•HTML 



pviblic static final java. lang. String HTML 
•ID_REWRITE_TOKEN 

public static final java. lang. String ID_REWRITE_TOKEN 
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IDTOKEN 



public static final java. lang. String ID_TOKEN 
•JOBTITLETOKEN 

piiblic static final java. lang. String JOBTITLE_TOKEN 
•LASTNAME_<jOL 

pviblic static final java. lang. String LASTNAME_COL 
•LASTNAME_ENC_TOKEN 

public static final java. lang. String 

IiASTNAME_ENC_TOKEN 

•LASTNAME_TAG 

public static final java. lang. String LASTNAME_TAG 
•LASTNAME_TOKEN 

p\iblic static final java. lang. String LASTNAME_TOKEN 
•LC_PRIVACYPREFIX 

p\iblic static final java. lang. String LC_PRIVACYPREFIX 
•LISTITEMS_TOKEN 

public static final java. lang. String LISTITEMS_TOKEN 
•LOGIN_SERVLET_TOKEN 

public static final java. lang. String 

LOGIN_SERVLET_TOKEN 

•MASK_COL 

piiblic static final java. lang. String MASK_COL 
•MASK_TOKEN 

public static final java. lang. String MASK_TOKEN 
•MIDDLENAMECOL 

public static final java. lang. String MIDDLENAME_COL 
•MIDDLENAMETAG 

public static final java. lang. String MIDDLENAME_TAG 
•MIDDLENAMETOKEN 

piablic static final java. lang. String MIDDLENAME_TOKEN 
MSG_LIST_TOKEN 
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p\±)lic static final java. lang. String MSG_LIST_TOKEN 
NEWUSERTAG 

public static final java. lang. String NEWUSER_TAG 
•OK_TAG 

public static final java. lang. String OK_TAG 
•ONETIME_TAG 

public static final java. lang. String ONETIME_TAG 
•PAGE_TAG 

public static final java. lang. String PAGE_TAG 
•PAGE_TOKEN 

public static final java. lang. String PAGE_TOKEN 
•PASSWORD_COL 

public static final java. lang. String PASSWORD_COL 
•PASSWORDTOKEN 

public static final java. lang. String PASSWORD_TOKEN 
•PDAPAGETAG 

p\ablic static final java. lang. String PDAPAGE_TAG 
•PERSONALLISTIDCOL 

public static final java. lang. String 

PERSONALLISTID_COL 

•PERSONALLISTITEMS_TOKEN 

pxiblic static final java. lang. String 

PERSONALLISTITEMS_TOKEN 

•PHONEID_TAG 

piablic static final java. lang. String PHONEID_TAG 
•PRIVACYPREFIX 



public static final j ava . lang . String PRIVACYPREFIX 
•PVTALTHRSTNAME TOKEN 

public static final java. lang. String 
PVTALTFIRSTNAME_TOKEN 
PVrBUSINESSCOMMENT_TOKEN 
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public static final java. lang. String 
PVTBUS INESSCOMMENT_TOKEN 
•PVTCOMPANYNAME_TOKEN 

public static final j ava . lang . String 
PVTCOMPANYNAME_TOKEN 

•PVTCONTACr_COL 

public static final java. lang. String PVTCONTACT_COL 
•PVTFIRSTNAME_TOKEN 

p\iblic static final j ava . lang . String 

PVTFIRSTNAME_TOKEN 

•PVrjOBTITLE_TOKEN 

public static final java. lang. String 

PVTJOBTITLE_TOKEN 

•PVTLASTNAMETOKEN 

public static final java. lang. String 

PVTLASTNAME_TOKEN 

•PVTLISTIDCOL 

public static final j ava . lang . String PVTLISTID_COL 
•PVTLISTIDTOKEN 

public static final java. lang. String PVTLISTID_TOKEN 
•PVTMIDDLENAME_TOKEN 

public static final java. lang. String 

PVTMIDDLENAME_TOKEN 

•PVTSUFFIX_TOKEN 

pxablic static final java. lang. String PVTSUFFIX_TOKEN 
•PVTTITLE_TOKEN 

public static final java . lang. String PVTTITLE_TOKEN 
•PVTWEBPAGEURL_TOKEN 

public static final java. lang. String 
PVTWEBPAGEXJRL_TOKEN 

•ROWID_TAG 

p\ablic static final java. lang. String ROWID_TAG 



SEARCHIDTAG 

piiblic static final java. lang. String SEARCHID_TAG 
•SEARCHLISTITEMS_TOKEN 

public static final j ava . lang . String 

SEARCHLISTITEMS_TOKEN 

•SEARCHNAME_TAG 

piiblic static final java. lang. String SEARCHNAME_TAG 

• SEARCH SERVLET TOKEN 

public static final java . lang. String 

SEARCH_SERVLET_TOKEN 

•SEARCH TAG 

public static final java. lang. String SEARCH_TAG 

• SITE_ADDRESS_TOKEN 

public static final java. lang. String 

S ITE_ADDRESS_TOKEN 

•SOUNDEX_TAG 

public static final java. lang. String SOUNDEX_TAG 
•SUFFIXCOL 

public static final java. lang. String SUFFIX_COL 
•SUFFIXTOKEN 

public static final java. lang. String SUFFIX_TOKEN 
•TEMPLATE 

public static final java. lang. String TEMPLATE 
•TITLE COL 



public static final java. lang. String TITLE_COL 
•TITLE TOKEN 



public static final java. lang. String TITLE TOKEN 
•UPDATE TAG 



public static final java. lang. String UPDATE_TAG 
•USERINFOIDTAG 

piiblic static final java. lang. String USERINFOID TAG 
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USERSID^COL 

public static final java . lang. String USERSID_COL 
•USERSID_TOKEN 

public static final java. lang. String USERSID_TOKEN 
•WEBPAGEURL ENC_TOKEN 

public static final java . lang. String 

WEBPAGEURL_ENC_TOKEN 

•WEBPAGEURLTOKEN 

public static final java . lang. String WEBPAGEURL_TOKEN 
•WHERE AMI 

public static final short WHEREAMI 
•WHEREAMI_TAG 



public static final java. lang. String WHEREAMI_TAG 

•miL 

public static final java . lang. String WML 
•monthNames 



public static final java . lang. String [] monthNames 
Static anay with the names of the months for fonmtting dates 
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Class ecardfile.appl.CommonApplicationlnterfa 



Object 



+ RemoteOb j ect 



+ RemoteServer 



+ UnicastRemoteObject 



+ Applicationlnterf ace 



+ 



ecardf ile . appl : CommonApplicationlnterf ace 

public abstract class CommonApplicationlnteiface 

extends AppHcntionlnterface 
implements SessionTags , CommonConfig 
Version: 

$Id: CommonApplicationInterface.java,v 1.44 1999/12/03 02:05:45 peter 
Exp $ 
See Also: 

AppHcationIntertace > SearcL^ppHcationlntertacC y 
LoginApplicationInterface > RequestHandler ^ LoginSen^leu . SearchSenlet 



# ac c e s s De nied (String, litpServletRequest, littpServletResponse) 

Called when a received request does not contain a valid session id 
• addBannerToken (Hashtable) 

Add the banner text to the token table 
• c hec kAcc es s (FfctpSeryletReguest) 

Implementation of ApplicationInterface::checkAccessO. 
•c hec kPri va c vAc cess (DatabaseConnection2, long, long, Hashtable) 
> db_e nx)r (I-fapServletRequest, ffepServletResponse) 

A database error has occurred 




» defaultPdaPage 
• verbose Errors 




^cardfile.appLCorrunonApplicationlnterface Q 
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»db_e mo r (HttpServletReqiie$t, PfttpSeivletResponse, String) 

A daubase error has occurred 
»de$troy O 

Brush teeth before going to bed 
»doc a c c e s s_e rtx)r (IfopServletReque$t. FitpServletResponse) 

A document access error has occurred 
# gctCookie (HtpServletRequest) 

Extract and return our cookie contents from the ordinal HTTP request. 
• getCookieTng O 
» gctFullPath (String) 

Given an HTML document name determine if a full path was specified 
> ge tOpe m tic n (FfapServletRequest) 

Determine the type of operation to be invoked by the request. 
•getPassword (FfetpServletRequest) 

Get a string representing the user's password 
» getSenletImgBtnParameter (HtpServletRequest) 
•getSessiordd (litpServletRequest) 

Extract and return the session id from the original HTTP request. 
» ge tUs e rl d (HttpServletRequest) 

Get a string representing the user identification 
•hiddenField (String, String) 

Return a string of HTML specifying a hidden field. 
•init(ApplServlet, String, String) 

Used to initialize the application specific class which implements this 

interface. 

> io_enx)r (tfapServletRequest, FitpServletResponse) 

An io exception has occurred 
•jsLoggedln (String, Session) 

Galled to check if a user is logged in 
»nfe e mor (HttpSen^letRequesL JfepServIetResponse) 

A Nuni)erFormatException has occurred 
» nfe_e mor (HttpSeryletRequest, HttpServletResponse, String) 

A Nunri)erFormatException has occurred 
» n5C_error (PfapServletR£quest, litpServletResponse) 

A non-serializable exception has occurred 
»operatioiiRequiresLog in(String) 

Called to check if a specified operation requires user login. 
»re_e nx)r (FfapSeryletRequesty HttpServletResponse) 

A Remote Exception has occurred 
»sae_e rror (I^tpServletRequest, HttpServletResponse) 

A Session Access Exception has occurred 
»s e nd Doc ume nt (String, I-fetpServletResponse) 

Send an HTML document to the user replacing the predefined character 

sequences with their associated values. 
#sendError (String, String, String, HttpServletResponse) 
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•sendEnar(Hashtable, String, String, String, litpServletResponse) 
• s e ndE m)r (Hashtable, String, String, FfapServletResponse) 
•sendEiTOr(FitpServletRequest, String, String, FttpServletResponse) 

General error handling routine. 
» $endLoginScneen (HfctpServletRequest. HttpServletResponse, String) 
• sendLoginScreen (FfctpServletRequesL PitpSeivletResponse, String, Hashtable) 
• sendMcssag e (String. String, Hashtable, String, FfetpSeivIetResponse) 
•sendMessage (String, Strir^, FfctpServletResponse) 
9 S e ndMe s sage (String. Hashtable, String, litpServletResponse) 
#s e nd Pa e Doc ume nt (Hashtable. String, String, JitpServletResponse) 
• s e nd Pa rs e Doc ume nt (Hashtable. Strii^, fitpServletResponse) 

Send an HTML document to the user replacing the predefined character 

sequences with their associated values. 
» sendParscTextFile (String. String, Hashtable, String, String, 
HttpServletResponse) 

»sendParseTextfile (String. Ifchtable, String, String, I-fctpServletResponse) 
» s e nd Pa rs e Te xtF i le (Hashtable. String. String, fitpServletResponse) 

Send a text file to the user replacing the predefined charaaer sequences 

with their associated values. 
• scndScarchScngen (FfapServletRequest, PfapServletResponse) 
• s e ndSe a nc hSc ne e n (FfapServletRequest. HttpServletResponse, String) 
# sendScairhScreen (F&tpServletRequest, JitpServletResponse, String, Hashtable) 
# s e s s i o nFa i 1 u ne (String. FfepServletRequest) 

Implementation of ApplicationInterface:sessionFailure Notify the 

application that an atten^t to access a sesssion using sessionid failed. 
> uiiknownOpe ration (FfctpServletRequest, HttpServletResponse) 

An unknown operation has been requested 
# \ a lida te Se s $ i o n (String. Session, PfepServletRequest) 

Validate the passed session This method can also be used to implement 

any security checks or other checks such as if undesirables are accessing 

the site - such as SPAMMERS 
• \'e rbos e E nx> r (String) _ 

Method, which displays verbose error, messages to user if debug is turned 

on 

yar/a^/es 

•defaultPdaPage 

piiblic static final java.lang.String defaultPdaPage 

•veiboseEiTors 

protected boolean verboseErrors 

CoftsPrMcPors 

i^CommonApplicationlnterface 
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pxiblic CommonApplicationlnterfaceO throws RemoteException 
•accessDenied 

public void accessDenied( String operation, 

HttpServletRequest req, 
HttpServletResponse resp) 
Called when a received request does not contain a valid session id The 
application should return an error/ warning document to the user. If the 
error occurred during a normal operation (i.e. other than Logging in or 
Logging out) it was more than likely due to the session having expired. In 
this case just bring up the login screen. 
Parameters: 

op)eration - The operation which was beir^ attempted, 
req - The original HTTP request, 
resp - Tlie HTTP respx^nse 
Overrides: 

accessDenied in class Applicationlnterface 
•addBarmerToken 

protected void addBannerToken (Hashtable tokens) 

Add the barmer text to the token table 

Parameters: 

tokens - the token table 
•checkAccess 

public boolean checkAccess (HttpServletRequest req) 

Implementation of AppIicationlnterfacerrcheckAccessQ. Qieckthe HTTP 
request data and decide if access should be allowed We check to see if the 
IP Address is locked out. 
Parameters: 

req - Tlie original HTTP request data. 
Returns: 

An indication if access is to be granted 
Overrides: 

check.\ccess in class Applicationlnterface 
•checkPrivacyAccess 

public short checkPrivacyAccess ( DatabaseConnection2 jdbc, 

long userld, 
long cardid, 
Hashtable cardRow) 

•dberror 

public void db_error (HttpServletRequest req, 

HttpServletResponse resp) 
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A database error has occurred 
Overrides: 

db_error in class Applicationlnterface 
•db_error 

public void db_error (HttpServletRequest req, 

HttpServletResponse resp, 
. String msg) 

A database error has occurred 
Overrides: 

db_error in class Applicationlnterface 
•destroy 

protected void destroy () 

Brush teeth before going to bed. 
Overrides: 

destroy in class Applicationlnterface 
•docaccesserror 

public void doc_access_error (HttpServletRequest req,. 

HttpServletResponse resp) 
A document access error has occurred 
Overrides: 

doc_access_error in class Applicationlnterface 
•getCookie 

public java.lang. String getCookie (HttpServletRequest req) 

Extract and return our cookiie contents from the ordinal HTTP requesL 
Tlie cookie used by this application holds the session id. 
Parameters: 

req - the original HTTP requesL 
Returns: 

the session id associated with the request. If no session id is found returns 
null 

•getCookieTag 

public java.lang. String getCookieTag ( ) 
•getFuUPath 

protected java. lang. String getFull Path (String document) 

Given an HTML document name determine if a full path was specified If 
not tack geiProperty("ecardfile.htmLbase") on to the front of the 
document 
Parameters: 

document - the filename of the HTML document to be sent 
Returns: 

full URL of document 



getOpe ration 

piiblic java.lang. String getOperation (HttpServletRequest req) 

Determine the type of operation to be invoked by the request. Note that 

session creation and session destruction requests are indicated by the 

operation strings defined by RequestHandler.CE^E ATE and 

RequestHandlerDESTROY respectively 

Parameters: 

req - The HTTP request. 

Returns: 

A string describing the operation to carry out. 
Overrides: 

getOperation in class Applicationlntertace 
•getPassword 

public java.lang. String getPassword (HttpServletRequest req) 
Get a string representing the user's password 
Parameters: 

req - The original HTTP request data. 
Returns: 

A string containing the password or null if the password tag isn't found in 

the HTTP request. 

Overrides: 

getPassword in class Applicationlnteiface 
•getSendetlnigBtnParameter 

public java.lang. St ring 

getServletlmgBtnParameter (HttpServletRequest req) throws 

ServletException, lOException 

•getSessionld 

public java.lang. String getSessionld (HttpServletRequest req) 
throws ServletException, lOException 

Extract and return the session id from the ordinal HTTP request. 

Parameters: 

req - the original HTTP request. 
Returns: 

the session id associated with the request. If no session id is found returns 
null. 

Throws: ServletException 
Throws: lOException 
Overrides: 

getSessionld in class Applicationlntertace 
•getUserid 

public java.lang. St ring getUserld (HttpServletRequest req) 
Get a string representing the user identification 
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Parameters: 

req - TTie original HTTP request data. 
Returns: 

A string containing the user id or null if the user id tag isn't found in the 

HTTP requesL 

Overrides: 

getUserld in class Applicationlnterface 
•hiddenField 

protected java. lang. String hiddenField (String name, 

String value) 
Return a string of HTML specifying a hidden field 
Parameters: 

name - NAME of the hidden field 
value - VALUE of the hidden field 
Returns: 

HTML string as described above. 

• init 

public void init ( ApplServlet servlet. 
String manage rName, 

String rmiHost) throws ServletException, 

lOException 

Used to initialize the application specific class, which implements this 
interface. The servlet configuration is passed in so that the servlet 
environment is available to the application code. 
Parameters: 

applServlet - "Hie Servlet instance which owns this Applicationlnterface 
instance. 

Throws: ServletException 
Overrides: 

init in class AppHcaiionlmertace 
•ioeiTor _ 

public void io_error (HttpServletRequest req, 

HttpServletResponse resp) 
An io exception has occurred 
Overrides: 

io^error in class AppHcaiionlniertace 
•isLoggedIn 

protected boolean isLoggedIn (String sessionld. 

Session session) throws 

SessionAccessException , lOException 

Called to check if a user is logged in 
Parameters: 

sessionid - The Id of the current session 



31 



session - Tlie cumeni session 
Returns: 

Tme if the user is currently logged in 
•nfeenor 

public void nf e_error (HttpServletRequest req, 

HttpServletResponse resp) 
A NumberFormatException has occurred 
Overrides: 

nfe_error in class Applicationlnteiiace 
•nfeeiror 

public void nfe_error (HttpServletRequest req, 

HttpServletResponse resp, 
String msg) 
A NumberFormatException has occurred 
Overrides: 

nfe_en-or in class Applicationlnteriace 
•nseerror 

public void nse_error (HttpServletRequest req, 

HttpServletResponse resp) 
A non-serializable exception has occurred 
Overrides: 

nse_error in class Applicanonlntertace 
•operationRequiresLogin 

protected boolean operationRequiresLogin (String operation) 
Called to check if a specified operation requires user login. 
Parameters: 

operation - Hie operation which was being attempted. 
Returns: 

True if the operation requires login, false otherwise 
•reerror 

public void re_error (HttpServletRequest req, 

HttpServletResponse resp) 
A Remote Exception has occurred 
Overrides: 

re_error in class Applicntionlnterface 
•saeerror 

public void sae_error (HttpServletRequest req, 

HttpServletResponse resp) 
A Session Access Exception has occurred 
Overrides: 
. sae^error in class Applicaiionlnterface 
sendDocument 
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public void sendDocument (String document, 

HttpServletResponse resp) 
Send an HTML document to the user replacing the predefined character 
sequences with their associated values. 
Parameters: 

document - the file name of the PTIML document to be sent. All 
documents are accessed relative to our ecardf ile.htmLbase property 
resp - provides methods to respond to the original HTTP request 
•sendEiror 



piiblic void sendError (String format, 

String msgl, 
String msg2, 

HttpServletResponse resp) 

•sendEnor 

pviblic void sendError (Hashtable tokens, 

String format, 

pr-j String msgl, 

.! String msg2, 

'^,z HttpServletResponse resp) 

il •sendError 

public void sendError (Hashtable tokens, 
ly string msgl. 

String msg2, 

yi HttpServletResponse resp) 

£ •sendError 

fij public void sendError (HttpServletRequest req, 

12: String msgl, 

fi". String msg2, 

if HttpServletResponse resp) 

pf General error handling routine. 

^" Overrides: — 

sendError in class Application! merf ace 
•sendLoginScreen 



protected void sendLoginScreen (HttpServletRequest req,. 

HttpServletResponse resp, 

String format) throws lOException 

•sendLoginScreen 

protected void sendLoginScreen (HttpServletRequest req, 

HttpServletResponse resp. 
String format, 

Hashtable initTokens) throws 

lOException 
sendMessage 
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public void sendMessage {String pdaPage, 

String MessageFile, 
Hashtable tokens, 
String format, 
HttpServletResponse resp) 

•sendMessage 

public void sendMessage {String MessageFile, 

String format, 
HttpServletResponse resp) 

•sendMessage 

public void sendMessage (String MessageFile, 

Hashtable tokens, 
String format, 
HttpServletResponse resp) 

•sendParseDocument 

public void sendParseDocument (Hashtable tokenTable, 

String document. 
String format, 
HttpServletResponse resp) 

•sendParseDocument 

public void sendParseDocument (Hashtable tokenTable, 

String document, 
HttpServletResponse resp) 

Send an HTML document to the user replacing the predefined character 

sequences with their associated values. 

Parameters: 

tokenTable - the tokens and values to be replaced in the document 
document - the file name of the HTML document to be sent. All 
docimients are accessed relative to our ecardfile.htnJ.base property 
session. 

resp - provides methods to respond to the original HTTP request 
•sendParseTextFile 



public void sendParseTextFile {String contentType, 

String fileName, 
Hashtable tokenTable, 
String document, 
String format, 
HttpServletResponse resp) 

•sendParseTextFile 

public void sendParseTextFile (String contentType, 

Hashtable tokenTable, 
String document, 
String format, 
HttpServletResponse resp) 



s e ndPars eTextFile 



public void sendParseTextFile (Hashtable tokenTable, 

String document, 
String format, 
HttpServletResponse resp) 

Send a text file to the user replacing the predefined character sequences 

with their associated values. 

Parameters: 

contentType - The content type of the text file 

tokenTable - the tokens and values to be replaced in the document 

document - the file name of the HTML document to be sent. All 

documents are accessed relative to our ecardfile.html.base property 

session. 

format - the type of file to send, html or wml 
resp - provides methods to respond to the original HTTP request 
•sendSearchiScreen 

protected void sendSearchScreen{HttpServletRequest req, 

HttpServletResponse resp) 

•sendSearchScreen 

protected void sendSearchScreen (HttpServletRequest req, 

HttpServletResponse resp, 
String format) throws 

lOException 
•sendSearchScreen 

protected void sendSearchScreen (HttpServletRequest req, 

HttpServletResponse resp, 
String format, 

Hashtablie initTokens) throws 

lOException 
•sessionFaillue 

public boolean sessionFailure (String sessionid, 

HttpServletRequest req) 
Implementation of ApplicationlnterfacersessionFailure Notify the 
application that an attempt to access a session using sessionid failed This 
could be due to a bogus sessionid or an expired session. We keep track of 
the failures per IP Address so that they can be checked in checkAccessQ 
Parameters: 

req - The original HTTP request data. 

sessionid - The session id string for the current session. 

Returns: 

If true a new session will be created 
Overrides: 

sessionFailure in class Application! nterf ace 
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unknownOpe ration 

public void unknownOperation(HttpServletRequest req, 

HttpServletResponse resp) 
An unknown operation has been requested 
Overrides: 

unkno\^Ti Ope ration in class Applicationlnterface 
•validateSession 

public boolean validateSession (String sessionid, 

Session session, 
HttpServletRequest req) throws 

Exception 

Validate the passed session Hiis method can also be used to implement 
any security checks or other checks such as if undesirables are accessing 
the site - such as SPAMMERS 
Parameters: 

session - The session to validate, 
req - The original HTTP request data. 
Returns: 

An indication if the session is valid 
Overrides: 

validateSession in class Applicationlntertace 
•veiboseError 

protected java.lang. String verboseError (String msg) 

Method which displays verbose error messages to user if debug is turned 
on 



36 



Class ecardfile^ppl.EcardNotifier 

Ob j ect 

I 

+ ecardf ile.appl .EcardNotif ier 

public class EcaidNotifier 

extends Object 
implements Runnable 

CoiisPrHCpor liidey^ 

o ecardfile.appl.Eca rdNorifie r (CommonApplicationInterf ace. String, long, 
String) 

• interrupt O 
•runO 
•stnjtO 
•stopO 

CofisPnicPors 

i^EcaidNotifier 

public EcardNotif ier ( Commori^ xpl i cat icnint erf ace parent. 

String templateCache, 
long cardid. 
String eCardId) 

M^phods 

•interrupt 

public void interrupt () 
•run 

public void runO 
•start 

public void start () 
•stop 

public void stopO 
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Class ecarcffiie^ppl.LoginApplicationinterface 



Object 



+ Remo t eOb j e c t 



+ RemoteServer 



+ UnicastRemoteOb j ect 



+ Ap plicationlnterf ace 



I 

+ - 



CommonAppl i cat ionlnter face 



+ 



ecardf ile . appl . LoginApplicationlnterf ace 



public class LoginApplicationlnteiface 

extends CommorL^pplicationlnterface 
implements CommonConfig 

The class implements the application behavior for the LoginServlet. Many of the 
methods are hooks called by RequestHandler instances invoked byLoginServlet 
(i.e. ApplServlet). 
Version: 

$Id: LoginApplicationInterface.java,v 123 1999/11/24 02:24:41 peter Exp 
$ 

See Ako: 

RequestHandler , LoginServlet, CommonConfig . Sessionlmpl 



•accessDenied (String, HttpServletRequest, HttpServletResp)onse) 

Called when a received request does not conuin a valid session id 

> n u the ntic a te Us e r (String, String, HttpServletRequest) 

Authenticate the user usii^ a user id and password combination. 

•execute Opera tion (String, String, Session, HttpServletRequest, 

HttpServletResponse) 

CaUed by RequestHandler to execute an application defined operation. 

•getCookieTagO 

Return the application specific cookie tag 




^cardfile.appl.LoginApplicationlnterface O 
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•init(ApplServlet, String, String) 

Used to initialize the application specific class which implements this 

interface. 
•notih^(SessionNotification) 

Receives (asynchronous???) notifications from XXX This overrides the 

corresponding method in Applicationlnterface which in turn in^lements 

the method 

» posL\utheriticate (String. Session, litpServletRequest, HctpServ^letResponse) 

Post authentication functionality, 
• pes tPe s troy (FfapServletRequesL tfepServletResponse) 

Called by the RequestHandler immediately after the destruction of the 

session objea. 

• p re De s troy (String, Session, titpSen^letRequest, HctpServletResponse) 

Called by RequestHandler prior to the destruction of the session object. 



^LoginApplicationlnterface 

public LoginApplicationlnterfaceO throws RemoteException 



•accessDenied 

public void accessDenied (String operation, 

HttpServletRequest reg, 
HttpServletResponse resp) 
Called when-a received request does not contain a valid session id. The 
application should return an error/ warning document to the user. If the 
error occurred during a normal operation (Le. other than Lx)gging in or 
Logging out) it was more than lilily due to the session having expired. In 
this case just bring up the login screen. 
Parameters: 

operation - Hie operation which was being attempted, 
rcq - The original HTTP request, 
resp - The HTTP response 
Overrides: 

accessDenied in class CommonApplicationlntert'ace 
•authenticateUser 

public multiserv. sessionmgr .GenericSession 
authenticateUser { String userName , 
String password, 

HttpServletRequest req) throws RemoteException, 
SessionAccessException , NotSerializableException, 
Servlet Except ion, lOException 
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Authenticate the user using a user id and password combination. 
Authentication is done against the database. This method can also be used 
to implement any pre-session creation functionality. 
Parameters: 

userName - The user name string, 
password - The user's password string, 
req - The or^al HTTP request data. 
Returns: 

A session objea containir^ any initial session data. The returned object 
must be a sub- class of GenericSession. This will be used to initialize the 
session object in the session manager. If the authentication fails, null is 
returned 

Throws: RemoteException 

A problem occured while trying to create the session object in the 

SessionlVlanager 

Overrides: 

authenticateUser in class Application! nterface 
See Also: 

UserAuth, SessionlmpI 
•execute Ope ration 

public void executeOperat ion (String operation. 

String sessionid. 
Session session, 
HttpServletReguest req, 
HttpServletResponse resp) 

Called byRequestHandler to execute an application defined operation. 

Valid operations are: 

Arthroscopy 

Performed on Peter's knee 

Operations can be specification of the OP_TAG as a hidden field or as 
part of a Query String in a GET request. Alternatively, certain FORM 
buttons are defined to execute specific operations. 
Parameters: 

operation - Specifies the operation to perform. TTiis should be one of the 

operation strings returned by getOperation. 

session - An interface to the current session object. 

req - The data from the original HTTP requesL 

resp - Provides methods for responding to the request. 

Overrides: 

executeOperation in class Applicationlnterface 
•getCookieTag 

public java . lang. String getCookieTag () 
Return the application specific cookie tag 
Returns: 
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name of the application specific cookie 
Overrides: 

getG)okieTag in class CommonApplicationlniertace 

•init 

public void init ( ApplServlet servlet, 
String managerName, 

String rmiHost) throws ServletException, 

lOException 

Used to initialize the application specific class which implements this 
interface. Hie servlet conf^;iiration is passed in so that die seivlet 
environment is available to the application code. 
Parameters: 

applServlet - The Servlet instance which owns this Applicationlnterf ace 
instance. 

Throws: ServletException 
Overrides: 

init in class CommorLA.ppHcationlnterface 
•notify 

public void notify ( SessionNct if icaticn nofn) 

Receives (asynchronous??.^) notifications from XXX Hiis overrides the 
corresponding method in Applicadonlnterface which in tum implements 
the method 
Parameters: 

nofn - An interface to the object carrying notification information. 
Overrides: 

noiity in class Applicationlnteriace 
•postAuthenticate 

public void postAuthenticate (String sessionid, 

Sess ion session, 
HttpServlet Request req, 
HttpServletResponse resp) throws 

lOException, SessicnAccessException , ServletException, 

lOException 

Post authentication funcuonality. If the authentication had failed a screen 

displaying an appropraite message is displayed. 

Overrides: 

postAuthenticate in class Applic.nionlnterface 
•postDestroy 

piablic void postDestroy (HttpServletRequest req, 

HttpServletResponse resp) 
Called by the RequestHandler immediately after the destmction of the 
session object. The session is finished Display the Login screen. 
Parameters: 

req - Hie data from the original HTTP request. 
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resp - Provides methods for responding to the request. 
O^irides: 

postDestrov in class Application! nterf ace 
•preDestroy 

pviblic void preDes troy (String sessionid, 

Session session, 
HttpServletRequest req, 
HttpServletResponse resp) 

Called by RequestHandler prior to the destruction of the session objecL 

Parameters: 

session - An interface to the associated session object, 
req - The data from the original HTTP request, 
resp - Provides methods for responding to the request. 
Overrides: 

preDestroy .in class Applicationlnterface 
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Class ecardfile.appl.SearchApplicationlntefface 



object 

I 

+ RemoteObject 

• I 

+ RemoteServer 

I 

+ UnicastRemoteObject 

I 

+ A cp 1 i ca t i cnl n t e r f a ce 

I 

+ 

ComiTtonAppl i cat ionlncer face 

I ■ 

+ 

ecardf ile . appl . SearchApplicationlnterf ace 

public class SeatchApplicationlnterface 

extends CommorL^pplicationlnterface 
implements CommonConfig 

Hie class implements the application behavior for the SearchSen^let. Many of the 
methods arc hooks called by RequestHandler instances invoked by SearchServlet 
(i.e. ApplServlet). 
Version: 

$Id: SearchApplicationInterface.java,v 1.59 1999/12/03 01:10:09 peter 
Exp $ 
See Also: 

Requestl-Lindler , SearchServlet, CommonConfig , Sessionlmpl 

yariakle ItiJeyi^ 

. PRIVATE ACCESS 
. PUBLIC ACCESS 

CorfsPruePor 

^cntxlfile.appLSenn:h.\pplicationInterfncc () 

MePffod /ffts/ix^ 

•accessDenied (String, FfapServletRequest, PfepServletResponse) 

Called when a received request does not contain a valid session id 

• a uthe n ti c a te Us e r (String, String, FfapSenrletRequest) 

Authenticate the user using a user id and password combination, 

»checkPrivacyAcc ess (shorty P^htable) 
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Qiecks all values in the card that is about to be displayed, if the privacy 
value for any value is higher than that granted by the card's owner the 
element is removed from the hashtable and the value is not displayed 

•destnoyO 

Brush teeth before going to bed 
»executeOpention (String, String, Session, FfttpServletRequest, 
HttpServletResponse) 

Called by RequestHandler to execute an application defined operation. 
• getCookieTng O 

Return the application specific cookie tag 
» getPri\^acyAccess (DatabaseConnection2, long, long) 

Get the privacy mask for the logged in user and the card being displayed 
» getPri\ ncvAccess (DatabaseConnection2. long, long, Hashtable) 
•init(ApplServlet, String, String) 

Used to initialize the application specific class, which implements this 

interface. 
> notif\^ (SessionNotification) 

Receives (asynchronous???) notifications from XXX This overrides the 

corresponding method in Applicationlnterface which in tum implements 

the method 

» pos L\uthc ntic a te (String. Session, HctpServletRequest, I-fapServletResponse) 

Post authenricarion functionality. 
» postDestroy (FfapSeryletRequesL HttpServletResponse) 

Called by the RequestHandler immediately after the destruction of the 

session object. 

• p re De s troy (String. Session, PitpServletRequest, HttpServletResponse) 

Called by RjequestHandler prior to the destruction of the session object. 

yar!ai?les 

•PRIVATE_ACCESS 

piiblic static final short PRIVATE_ACCESS 
• PUBLIC_ACCESS 

public static final short PUBLIC_ACCESS 

Coffsprj/epors 

i^SearchApplicationlnterface 

public SearchApplicationlnterface ( ) throws RetnoteException 
9accessl>enied 

public void accessDenied {String operation, 

HttpServletRequest req, 
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HttpServletResponse resp) 
Called when a received request does not contain a valid session id. The 
application should return an enor/ wamii^ document to the user. If the 
error occured during a normal operation (Le. other than Logging in or 
Logging out) it was more than likely due to the session having expired In 
this case just brir^ up the login screen. 
Patameters: 

operation - The operation which was being attempted 
req - The original HTTP request 
resp - Tlie HTTP response 
Ovenides: 

accessDenied in class CommorL^pplicaiionl ntertace 
• authenticateUser 

public multiserv.sessionmgr.GenericSession 
authenticateUser (String userName, 

String password, 

HttpServletRequest req) throws RemoteException, 
Sessi onAccessException , NotSerializableException, 
ServletException, lOException 

Authenticate the user usir^ a user id and password combination. 

Authentication is done against the database. This method can also be used 

to implement any pre- session creation functionality. 

Parameters: 

userName - The user name string, 
password - Tlie user's password string, 
req - The original HTTP request data. 
Returns: 

A session objea containii^ any initial session data. The returned object 
must be a sub-class of GenericSession. This will be used to initialize the 
session objea in the session mans^er. If the authenricarion fails, null is 
returned ~ 
Throws: RemoteException 

A problem occurred vAuie trying to create the session object in the 

SessionManager 

Overrides: 

auiheniicateUser in class Applicaiionlmertace 
SeeAko: 

UserAuth, Sessionlmpl 
•checkPrivacyAccess 

p\ablic void checkPrivacyAccess (short privacyLevel, 

Hashtable cardRow) 
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Qiecks all values in the card that is about to be displayed, if the privacy 
value for any value is higher than that granted by the card*s owner the 
element is removed from the hashtable and the value is not displayed 
Parameters: 

privac)i^vel - Privacy value 

cardRow - Hashuble from which the elements are removed 
•destroy 

protected void destroy!) 

Brush teeth before goii^ to bed. 
Overrides: 

destro\- in class Gpmmon^A.pplicationlnterface 
• exec uteOpe ration 

public void executeOperat ion (String operation, 

String sessionid, 
Session session, 
HttpServletRequest req, 
HttpServletResponse resp) 

Called by RequestPtndler to execute an application defined operation. 

Valid operations are: 

Arthroscopy 

Performed on Peter s knee 

Operations can be specification of the OP_TAG as a hidden field or as 
part of a Query Strir^ in a GET request Alternatively, certain FORM 
buttons are defined to execute specific operations. 
Parameters: 

operation - Specifies the operation to perform. Hiis should be one of the 

operation strings returned by getOperation. 

session - An interface to the current session object. 

req - The data from the original HTTP request. 

resp - Provides methods for responding to the request. 

Overrides: 

executeOpemtion in class Applicationlntertnce 
•getCookieTag 

public java.lang. String getCookieTag { ) 
Return the application specific cookie tag 
Returns: 

name of the application specific cookie 
Overrides: 

getCookieTag in class CommonAppHcationlnterface 
•getPrivacyAccess 

public short getPrivacyAccess ( DatabaseConnection2 jdbc, 

long loginld, 
long cardid) 
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Get the privacy mask for the lo^ed in user and the card being displayed 
Parameters: 

jdbc - An open database connection 

loginid - user id of currently logged in user (0 if not logged in) 
cardid - user id of the card details beir^ checked 
card - Card to add mask and privacy row id if required 

• ge tPrivacyAccess 

public void getPrivacyAccess ( DatabaseCcnnect ion2 jdbc, 

long loginid, 
long cardid, 
Hashtable card) 

• init 

public void init (Ap plSer^v let servlet, 
String manage rName, 

String rmiHost) throws ServletException, 

lOException 

Used to initialize the application specific class, which implements this 
interface. The servlet configuration is passed in so that the servlet 
envirorunent is available to the application code. 
Parameters: 

applServlet - The Servlet instance which owns this Applicationlnterface 
instance. 

Throws: ServletException 
Overrides: 

init in class CommonApplicationlnterfnce 
•notify 

public void notify ( SessionNot if ic at ion nofn) 

Receives (asynchronous?.^?) notifications from XXX This overrides the 
corresponding method in Applicationlnterface which in turn in^lements 
the method 
Parameters: 

nofn - An interface to the object carrying notification information. 
Overrides: 

notify in class Application] ntertace 
•postAuthenticate 

public void postAuthenticate {String sessionid, 

Ses sion session, 
HttpServletRequest req, 
HttpServletResponse resp) throws 
lOException, S essionAccessException , ServletException 

Post authentication functionality. If the authentication had failed a screen 

displaying an appropriate message is displayed 

Overrides: 

postAuthenticate in class Applicationlnterface 
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postDestroy 

public void postDestroy (HttpServletRequest req, 

HttpServletResponse resp) 
Called by the RequestHandler immediately after the destruction of the 
session objecL The session is finished. Display the Login screen. 
Parameters: 

req - The data from the original HTTP request. 

resp - Provides methods for respondir^ to the request. 

Overrides: 

postDestroy in class Applicationlntertace 
•pre Destroy 

public void preDestroy (String sessionid, 

Session session, 
HttpServletRequest req, 
HttpServletResponse resp) 

Called by RequestHandler prior to the destmction of the session object. 

Parameters: 

session - An interface to the associated session objecL 
req - The data from the original HTTP request, 
resp - Provides methods for responding to the request. 
Overrides: 

preDestroy in class ApplicationI nterface 
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package ecardfiie.dbappl 

Class Itidev^ 

• Address 

• Banner 

• BannerGiche 

• DatabaseConneaion2 

• Email 

• InactiveAddress 

• InactiveDatabaseConnection 

• InactiveEniail 

• InactivePhone 

• InactiveUser 

• LockedIP 

• Lookup 

• LookiipQche 

• PersonalList 

• Phone 

• PrivateList 

• User 

• Userlnfo , 

• UserObiect 

• WliereAnil 



Class ecarcffile-dbapplJUidress 



Object 

I 

+r -- JdbcObject 

I 

UserObject 

I 

+ ecardf ile . dbappl .Address 

public class Address 
extends UserObject 

CoMsPrMCpor If/^ey, 

^cardfile. dbappl.Addness (Connection) 

CoHsPmepors 

^Address 

piiblic Address (Connection connect) throws JdbcException 
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Class ecardfile-dbappLBanner 



Object 
I 

+ JdbcObject 

I 

+ ecardfiie .dbappl .Banner . 

public class Banner 
extends JdbcObiea 

CoffBprucPor iHdeK 

^caiidfile.dbappl.Banner (Connection) 

CottsPrMcpors 

^Banner 

public Banner (Connection connect) throws JdbcException 
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Class ecardfile.dbappl.BannerCache 



Object 

+ Cache 

I 

+ TableCache 

I 

+ ecardf ile .dbappl .BannerCache 

public class BanneiCache 
extends TableOche 
Cache of the Banner table 
See Ako: 

TableCiche 



CoffsPn/cPor 

^cardfile.dbappl.BaiiiierCache Q 

Shouldn't use this constructor 
^cardfile.dbappLBannetOiche (JdbcConnectionBroker2. long) 

M^Pffod Iftdgyt^ 

• getJdbcObject (Connection) 

This method should be defined in the sub class. 
• getRnndoirL\d () 

Get a random Banner ad 
^ populate Q 

The database table is populated by using a JDBC object created by 
getJdbcObject. 

CotfsPrucPors 

^BannerCache 

public BannerCache ( ) 

Shouldn't use this constructor 
BannerCache 

pub lie BannerCache(J dbcConnectionBr oker2 connMg r , 

long sees) throws lOException 

Parameters: 

coruiMgr - - The JDBC Cormection manager 
sees - - The cache is repopulated every 5ac5 seconds 
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getJdbcObject 

protected multiserv.dbmgr . JdbcObject getJdbcObject (Connection 
connect) throws JdbcException 

Hiis method should be defined in the sub class. 

Overrides: 

getJdbcObject in class TableGiche 
•getRandomAd 

public java. lang. String getRandomAd ( ) 

Get a random Banner ad. Basically it just returns an HTML Strii^ by using 

a random key into the banner table cache. 

Returns: 

String of HTML which can display an ad banner 
See Also: 
populate 
•popubte 

public void populate!) 

The database table is populated by using a JDBC objea created by 
getJdbcObject. We key a vector of keys locally. As records get 
added/ deleted from the table the set of Ids will change. To retrieve 
random ads we randomly index into out local set of keys and use that key 
to pull an add from the cache. 
Overrides: 

populate in class TableGiche 
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Class ecardfile.dbappl.DatabaseConnection2 



Object 

I 

+ JdbcConnection 



I 

+ ecardf ile .dbappl .DatabaseConnection2 



public class DatabaseConnection2 

extends JdbcConnection 

Yar/ai>/e 

. DEBUG 

CoMsPrMCpor ludeyi^ 

^cardfile.dbappLDatabaseConnection2 () 

Only to be used for JdbcConnectionBroker/JdbcConnectionFactory 
#ecandfile.dbappl.DatabaseConnection2 (String, String, String) 

• Address 0 

•BannerO 

•EmailO 

•Initialize O 

•LockedlPO 

» Lookup O 

» PersonalList O 

•PhoneO 

• Private List Q 

•UserO 

•WhereAmlO 
•doseQ 

•gednstance (String, String, String) 
» main (String[0 

yariakUs 

•DEBUG 

public static boolean DEBUG 

CofisPrucPors 

i^DatabaseConnection2 



public DatabaseConnection2 0 

Only to be used for JdbcConiiectionBnokcr/JdbcConncctionFaaory 

* DatabaseConnection2 



public DatabaseConnection2 (String URL, 

String usemame. 

String password) throws JdbcExcepticn 



•Address 

public ecardfile.dbappl. Address Address () throws JdbcExcept ion 
•Banner 

public ecardfile.dbappl. Banner Banner () throws JdbcE:-:cepticn 
•Email 

public ecardfile.dbappl. Email Email {) throws JdbcException 
•Initialize 

public void Initialize () throws JdbcExcepticn 
Ovenides: 

Initialize in class TdbcG^nnection 
•LockedIP 

public ecardfile.dbappl. LockedIP LockedlPO throws JdbcException 
•Lookup 

public ecardfile.dbappl. Lookup Lookup {) throws JdbcException 
•PersonalList 

public ecardfile.dbappl .PersonalList PersonalList ( ) throws 

JdbcExceotion 



public ecardfile.dbappl. Phone Phone () throws JdbcException 
•PrivateList 

public ecardfile.dbappl. PrivateList PrivateList ( ) throws 

J dbcExce pticn 



public ecardfile.dbappl. User UserO throws JdbcException 

•WheieAml 

public ecardfile.dbappl.WhereAmI WhereAmlO throws JdbcException 

•close 

piiblic void close 0 throws SQLException 




•Phone 



•User 
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Overrides: 

close in class JdbcConnection 
getlnstance 

public multiserv.dbmgr. JdbcConnection getlnstance {String URL, 

String 

usemame , 

String 

password) throws JdbcException 
Overrides: 

getlnstance in class JdbcConnection 

9 main 

public static void main (String [] args) 
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Class ecarcifiie.dbappl.Email 



Object 

I 

+ JdbcCbiecc 

I 

• ■ + UserObject 

I 

+ ecardfile .dbappl .Email 

public class Email 
extends UserObiect 

ConsPrMetor lude^ 

^cardfile. dbappl. Email (Connection) 

Cotfspriiepors 

^Email 

public Email (Connection connect) throws JdbcExceptio n 
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Class ecardfife.dbappi.lnactiveAddress 



Obj ect 
I 

+ JdbcObject 

I 

+ UserOb]ect 

+ ecardf ile . dbappl . InactiveAddress 

public class InactiveAddress 
extends UserObiect 



^InactiveAddress 

piiblic InactiveAddress (Connection connect) throws JdbcException 




^cardfile,dbappl.Inactive Address (Connection) 
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Class 

ecardfile.dbappl.lnactiveDatabaseConnection 

Object 
I 

+ ecardf ile .dbappl . InactiveDatabaseConnection 

public class InactiveDatabaseConnection 

extends Object 

yaria^le ludeyt^ 

. DEBUG 

CoMsPruePor 

^cardfile. dbappLInactive Da tabaseConne-ction (Gonnection) 

M^Pffod /ffdex^ 

• I nactive Address Q 
• InacdveEmail Q 
• IiiactivePhone O 
•InactiveUserQ 

yariahUs 

•DEBUG 

public static boolean DEBUG 

CofisPmepors 

d InactiveDatabaseConnection 

public InactiveDatabaseConnection (Connection conn) 

M^P^ods 

AInactiveAddrcss 

public ecardf ile .dbappl . InactiveAddress InactiveAddress ( ) throws 

Jdbc Exception 

OlnactiveEmail 

public ecardf ile . dbappl . InactiveEmail InactiveEmail ( ) throws 

Jd bcException 

InactivePhone 
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public ecardf ile . dbappl . InactivePhone InactivePhone ( ) throws 

J dbcEx ception 

InactiveUser 

public ecardf ile. dbappl. InactiveUser InactiveUser {) throws 

JdbcException 
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Class ecardfile-dbappl-lnactiveEmail 



Object 

I 

+ Jdb.cCbject 

I . 

+ UserObject 

I 

+ ecardf i le . dbappl . Inac t i veEmai 1 

public class Inac tiveE mail 

extends UserObiect 



'^InactiveEniail 

public InactiveEmail (Connection connect) throws JdbcException 




■p ecardfile.dbappl.InacriveEmail (Connection) 
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Class ecardfile.dbappl.lnactivePhone 



Object 

I 

+^-> JdbcObject 

I 

+ UserObject 

I 

+ ecardf ile .dbappl . InactivePhone 

public class InactivePhone 
extends UserObiect 

CoffsPrtiePor iMdev^ 

^candfile.dbappLlnacrivePhone (Connection) 

Cofispruepors 

^InactivePhone 

public InactivePhone {Connection connect) throws JdbcException 
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Class ecardfile.dbappl.lnactiveUser 



Object 

I 

+ JdbcObiiect 

I 

+ ecardf ii e . dbappl . InactiveUser 

public class InactiveUser 

•extends JdbcObiect 

CoffsPrMePor 

* e c n nd fi le . dba ppl. I na c ti vc Us e r (Connection) 

MePlfod /ff^ex^ 

•Delete (InactiveDatabaseConnection, long) 

•Get(Stnng) 

•Get(String, String) 

•lnsert(InactiveDatabaseConnection, StringQ, Veaor, Vector, Vector) 
• Update (InactiveDatabaseConnection, StrmgO, Vector, Vector, Vector) 

CofisPmePors 

'ii^ InactiveUser 

public InactiveUser (Connection connect) throws Jd bcException 

M^Pffods 

•Delete 

public int Delete ( InactiveDatabaseConnection database, 

long userld) throws JdbcException 

•Get 

public java.util .Hashtable Get (String szECardId) throws 

JdbcExceptio n 

•Get 

p\iblic java.util .Hashtable Get (String szECardId, 

String szSessionId) throws 

JdbcException 

•Insert 

public long Insert ( InactiveDatabaseConnection database. 

String [] userRow, 
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Vector addressRows, 
Vector phoneRows, 

Vector emailRows) throws JdbcExcep tion 

Update 

public long Update ( inactivePatabaseConnect ion database, 

String [] userRow, 
Vector addressRows, 
Vector phoneRows, 

Vector emailRows) throws JdbcException 
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Class ecardfiie.dbappl.LockedlP 



Object 
I 

+ JdbcO b"ect: 

I ^ 

+ ecardf ile.dbappl .LockedIP 

public class LockedIP 
extends JdbcObiect 

Yar/ai'/e lifdey^. 

•psAl] 

CoffBprHCpor ludeyt^ 

^cardfile. dbappl.LockedIP (Connection) - 

•QuervAUO 
•psAU 

protected j ava . sql . PreparedStatement psAll 

CoitsPniePors 

i^LockedlP 

public LockedIP (Connection connect) throws JdbcException 
•QueiyAU 

public java.util .Vector QueryAlK) throws Jd bcExca ptibn 
Ovemdes: 

Oiien.^ll in class JdbcObiect 
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Class ecardfiie.dbappl.Lookup 



Object 

I 

+ JdbcObject 

I 

+ ecardfile.dbappl .Lookup 

public class Lookup 
extends JdbcObiect 

Co»BprucPor 

^cnrdfile.dbappl.Lookup fConnection) 

CoHsPrueporg 

^Lookup 

public Lookup (Connection connect) throws JdbcException 
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Class ecardflle.dbappi.LookupCache 



Object 

I 

+ Cache 

I 

+ TableCache 

I 

+ ecardf ile .dbappl .LookupCache 

public class LookupCache 
extends T;ibleG\che 
Cache of the Lookup table 
See Also: 

TableCiche 

yariakle Mex, 

•ADDRESS 
. EMAIL 
. PHONE 
. USERINFO 

ConsPmetor ludeyt^ 

^cnrdfile.dbnppl.LookupCnche Q 

Shouldn't use this constmctor 
^cardrile.dbappl.LookupCichc (JdbcCQnnectionBir)ker2, long) 

• addLbokupTokens (Short, fiishtable) 

Put the Lookup tokens in the token Hashtable 
» addVcardTokens (Shoity Hashtable) 

Put the Vcard tokens in the token Hashtable 
• getJdbcObject (Connection) 

This method should be defined in the sub class, 
• populate 0 

Hie database table is populated by using a JDBC object created by 

getJdbcObject. 
• n^placeLookupTokcns (Short, String, int, Hashtable) 

Replace the Lookup tokens in the token Hashtable 
» re pla c e Vc a ndToke ns (Short, String, int, I-feshtable) 

Replace the Vcard tokens in the token Fishtable 
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yar/ai^/es 



ADDRESS 



public static final j ava . lang . Short ADDRESS 
•EMAIL 



public static final java. lang. Short EMAIL 

•PHONE 



public static final java. lang. Short PHONE 
•USERINFO 



public static final java. lang. Short USERINFO 



CofisPriiepors 



^i#LookupCache 

public LookupCache ( ) 

Shouldn't use this constructor 
i^LookupCache 

public LookupCache ( jQbcCGnnectionBrckei-2 conxiMgr, 



•addLookupTokens 

public void addLookupTokens ( Short category, 

Hashtable tokens) 
Put the Lookup tokens in the token Hashtable 
•addVcardTokens 

public void addVcardTokens (Short category, 

Hashtable tokens) 
Put the Vcard tokens in the token Hashtable 
•getJdbcObject 

protected multiserv.dbmgr . JdbcObject getJdbcObject (Connection 
connect) throws JdbcException 

This method should be defined in the sub class. 

Overrides: 

getJdbcObiecr in class TableQche 



long sees) throws lOException 




Parameters: 

conriN%r - - The JDBC Connection manager 
sees - - Hie cache is repopulated every sec? seconds 



populate 
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public void populate {) 

The database table is populated by using a JDBC object created by 
getJdbcObjecL We call populate from the super class then keep the data in 
an optimized form for local use. Hie form is as for a token table of the 
types. 
Overrides: 

populate in class TableGiche 

• replacelookupTokens 

public void replaceLookupTokens (Short category, 

String prefix, 
int allocatedRows, 
Hashtable tokens) 
Replace the Lookup tokens in the token Hashtable 

• replace VcardTokens 

public void replaceVcardTokens (Short category. 

String prefix, 
int allocatedRows, 
Hashtable tokens) 
Replace the Vcard tokens in the token Hashtable 



Class ecarcffile.dbappl.PersonalList 



Object 

I 

+ JcbcObject 

I 

+ UserOb:iect 

I 

+ ecardf ile . dbappl . PersonalList 

public class PersonalList 
extends UserObiect 



^canifile.dbappLPersonalList (Connection) 

MePkod ff/dgK 

•Delete (E>atabaseConnection2, long, long) 
» De le te B\<Ia rd I d (DatabaseConnection2, long) 

Note: Transaction should be setup around this method 
> De le te B \'Us e rl d (DatabaseConnection2, long) 

Note: Transaction should be setup around this method 
# 1 lis e rt (DatabaseConnection2, long, long, long, short) 
» IsCandThere (long. long) 
• Qu e r\' Co nti i ns Ci nJ (long) 
» Qii e r\ J o i nB yUs e rl d (long) 
•Que n j o i nB yUs e rl d N a me (long, char) 

Cofispruepors 

'^PersonalList 

public PersonalList (Connection connect) throws JdbcException 

M^Pkodg 

•Delete 

public int Delete ( DatabaseConnectio'n2 jdbc, 

long personalListId, 

long privateListId) throws JdbcException 

•DeleteByCardId 

public int DeleteByCardId ( DatabaseCGnnection2 jdbc, 

long cardid) throws JdbcException 
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Note: Transaction should be setup around this method 
•DeleteByUseiid 

public int DeleteByUserId( DatabaseCcnnecticn2 jdbc, 

long userld) throws JdbcSxception 
Note: Transaction should be setup around this method 
•Insert 

public long Insert ( DatabaseConn€ct:icn2 jdbc, 

long listid, 
long userld, 
long cardid, 

short mask) throws JdbcE:-:cep t icn 

•IsCardThere 

public boolean IsCardThere (long userld, 

long cardid) throws JdbcException 

•QueiyContainsCard 

public java.util -Vector QueryContainsCarddong cardid) throws 

JdbcException 

•QueryJoinByUseiid 

public java .util .Vector QueryJoinByUserlddong userld) throws 

JdbcException 

• QueryJoinByUserldName 

public java. util. Vector QueryJoinByUserldName (long userld, 

char lastlnitial) 

throws JdbcExceDtion 
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Class ecardfile.dbappl.Phone 



Object 

I 

+ JdbcQbj ecc 

I 

+ UserObject 

I 

+ ecardf ile .dbappl . Phone 

public class Phone 
extends UserObiect 

CoffsPrucPor 

ecardfile.dbappl.Phone (Connection) 

ConsPtMcPors 

^Phone 

public Phone (Connection connect) throws JdbcException 
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Class ecardfile.dbappl.PrivateUst 



Object 

I . 

+ JcbcOb^ect 

I . . 

+ UserObject 

I 

+ ecardf ile .dbappl .PrivateList 

public class PrivateList 
extends UserObject 

CoffsPrMCPor //r^fex 

^cardfile. dbappLPrivateList (Gonnection) 

# DeleteB}'CardId (long) 
•Get(Ior^, long) 
•UpdateMask (long, short) 

CoHsPmePors 

^PrivateList 

public PrivateList (Connection connect) throws JdbcException 

M^P^o^s 

•DeleteByCardld 

public long DeleteByCar did (long cardid) throws JdbcException 

•Get 

public java.util.Hashtable Get (long loginid, 

long cardid) throws JdbcException 

•UpdateMask 

public long UpdateMask (long privateListId, 

short mask) throws JdbcException 
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Class ecarcffile.dbappl.User 



Object 



hi 



+ JdbcObject 

I 

+ ecardf ile.dbappl .User 



public class User 
extends JdbcObiect 



CotfsPrHcPor iHde^ 

^candfilc.dbappl.Uscr (Connection) 

»Co n Fi rrn Us e r (String. String) 
•Delete (DatabaseConnection2, long) 
•Get (String) 

•GetFoiLogin (String, String) 

•lnsett(DatabaseConnection2, StringQ, Vector, Vector, Vector) 
•Oiie r\'B vF i rs tL a s tNa me (String. String) 
•Que r\'B vF i rs tL a s tN a me So und E x (String, String) 
•Update (DatabaseConnection2. StringQ, Vector, Vector, Vector) 

CofiBprucPors 

Dl 

O public User (Connection connect) throws JdbcException 

M^P^ods 

•ConfirmUser 

public int ConfirmUser (String eCardId, 

String createld) throws JdbcException 

•Delete ' 

public int Delete ( DatabaseConnection2 database, 

long userld) throws JdbcException 

•Get 

public java.util .Hashtable Get (String szECardId) throws 
JdbcException 
GetFoiLogin 
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public java.util .Hashtable GetForLogin (String szECardId, 

String szPassword) throws 

JdbcException 

Insert 

public long Insert ( DatabaseConnection2 database. 

String [] userRow, 
Vector addressRows, 
Vector phoneRows, 

Vector emailRows) throws JdbcException 
• QueiyByFiistLastNarae 

piiblic java.util .Vector QueryByFirstLastName (String szFirstName, 

String szLastName) 

throws J (;ibc Exc ept ion 

•QueryByFiistLastNameSoundEx 

public java.util .Vector QueryByFirstLastNameSoundEx (String 
szFirstName, 

String 

szLastName) throws JdbcException 

•Update 

public long Update ( DatabaseConnection2 database, 

String [ ] userRow , 
Vector addressRows, 
Vector phoneRows, 

Vector emailRows) throws JdbcException 
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Class ecardfile.dbappl.Userirtfo 



Ob j ect 

I 

+ JdbcObject 

I 

+ UserOb^ect 

I 

+ ecardf ile .dbappl .Userlnfo 

public class Userlnfo 
extends UserObject 

CoffsPrHCPor Indev. 

^ c a rdfile . dbappL Us e rl iifo (Connection) 

• Que r\'B vGite gor\' (long. short) 
•Update (long, Vector) 

CoffsPriiePors 

'«*Usetinfo 

piiblic Userlnfo (Connection connect) throws Jd bcException 

M^P^ods 

• QueryByCategory 

p\iblic java.util .Vector QueryByCategory (long cardid, 

short category) throws 

JdbcException 

•Update 

piiblic long Update (long userld, 

Vector rows) throws JdbcException 
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Class ecardfile.dbappI.UserObject 

object 

I 

+ JdbcCb:iecc 

I 

+ ecardf ile .dbappl .UserObject 

pubKc class UseiObject 
extends TdbcObiect 

CortsPmcPor lude^ 

^canjfile.dbappLUserObject (Connection> String, StringQ, intQ, intQ) 

MeP^od /ffdeK 

> De le te By Us e rl d (long) 
♦ Insert (long, StringQ) 
• OiiervByUserld (int) 
• Que r\ B yUs e rl d (long) 
• Update (long, StringQ) 

Cotfsprucpors 

i^UseiObject 

public UserObject (Connection connect, 
String table, 
String [ ] columnNames , 
int columnLength, 

int columnTypes) throws JdbcEx cect ion 

M^P^odg 

•DeleteByUseiid 

public long DeleteByUserld (long userld) throws JdbcExcept ion 
•Insert 

public long Insert (long userld, 

String [] row) throws JdbcExce ption 

•QueiyByUserid 

public java.util. Vector QueryByUserld (int userld) throws 

J dbcExcep tion 

QueiyByUserid 
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public java.util. Vector QueryByUserld (long userld) throws 
JdbcException . 
Update 

piiblic long Update (long userld, 

- String [] row) throws JdbcExc epcicn 

Overrides: 

Update in class JdbcObiect 
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Class ecarclfile.dbappl.WhereAml 



Object 
I 

+ JdbcObiecc 



+ UserObject 

I 

+ ecardf ile . dbappl . WhereAml 

public class WhereAml 
extends Us'erObiect 



CoilBprnePor Indey^ 

^ c a txd fi le . dbn ppl . ^Iie re Ami (Connection) 

» G€t\MthDate (long) 

• Oiie rvB\'E xpin (long. String) 

• Update (long. StnngQ) 

CotisPruePors 

^WhereAml 

public WhereAml (Connection connect) throws JdbcExcepcior. 

M^P^ods 

•GetWithDate 

public. java.util .Hashtable GetWithDate (long cardid) throws 

J dbcEx cep tic- n 

•QueiyByExpiiy 

public java.util .Vector Que ryByExpiry (long cardid, 

String expDate) throws 

JdbcExceoc icn 

•Update 

public long Update (long userld, 

String [] row) throws JdbcException 

Overrides: 

Update in class UserObiect 
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package muttiserviapplserviet 

Class Iftdex, 

• ApplSen^let 

• Applicationlmerlace 

• RequestHandler 

• SessionTable 
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Class multfserv^pplservletApplServlet 



Object 



+ GenericServlet 



+---HttpServlet 



+ multiserv.applservlet . ApplServlet 



public class ApplSendet 



extends HttpServlet 
The base class for all Servlets which use the Multi Server/Multi Servlet . 
environment, implication servlets should extend this class. 

For most cases, only the getApplicationInterface() needs to be overridden so 
that it returns the appropriate application specific implementation of 
Applicationlnterface. 



» decrCurrentCount O 
• destroy O 

•doGet(HctpServletRequest, HttpServletResponse) 

Overrides the doGet mediod provided by the HttpServlet superclass. 
•doPost(HttpServletRequest, PitpServletResponse) 

Overrides the doPost niethod provided by the HttpServlet superclass, 
^ get^plicationl nte rface Q 

Defines a method which rctums an instance of ^plicationlnterface. 
•getPropertv (String) 
• getSessioiLMgr Q 
• incrCumentCount O 
•init(ServletConfig) 

Called when the servlet first gets loaded 
•log (String) 

• setSessionMgrSLite (int) 
• trace (String) 



CoHsPritePor /f/dsK 





'^ApplSeniet 
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public ApplServlet ( ) 
•deciCurrentCount 

piiblic synchronized void decrCurrentCount ( ) 

•destroy 

piiblic void destroy {) 
Overrides: 

destroy in class GenericServlet 
•doGet 

public void doGet (HttpServletRequest req, 

HttpServletResponse resp) throws 

ServletException, lOException 

Overrides the doGet method provided by the I-fttpServlet superclass. The 
serviceO method of HtpServlet handles the setup and dispatching to all 
doXXXQ methods, ^s^4iich is ^y it usually should not be overridden. 
Parameters: 

req - The HTTP server request data. 

resp - Provides methods to respond to the request. 

Throws: ServletException 

a problem occurred during the processing of the request. 

Throws: lOException 

an I/O problem was encountered. 

Overrides: 

doGet in class HtpServlet 
See Also: 
doPost 
•doPost 

public void doPost (HttpServletRequest req, 

HttpServletResponse resp) throws 

Servlet Except ion , lOExcept ion 

Overrides the doPost method provided by the PitpServlet superclass. The 
serviceO method of HtpServlet handles the setup and dispatching to all 
doXXXQ methods, which is why it usually should not be overridden. 
Parameters: 

req - The HTTP server request data. 

resp - Provides methods to respond to the request. 

Throws: ServletException 

a problem occurred during the processing of the request. 

Throws: lOException 

an I/O problem was encountered. 

Overrides: 
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doPost in class PfapServlet 
See Also: 

doGet 

• getApplicadonlnteiface 

public multiserv.applservlet .Applicationlnterface 

getApplicationlnterf ace ( ) 

Defines a method vAnch returns an instance of Applicationlnterface. Hiis 
must be overridden in a subclass to provide an instance of a class which 
implements the methods defined in Applicationlnterface. 

•getPioperty 

public java.lang. String getProperty (String propName) 
•getSessionMgr 

public synchronized multiserv. sessionmgr . SessionMgr 
getSessionMgr ( ) throws NotBoundException, RemoteException, 
Ma 1 f orme dURLExc ep t i on 

• inciCurrentCount 

public synchronized void incrCurrentCount ( ) 
•init 

public void init (ServletConf ig config) throws ServletException 

Called when the servlet first gets loaded. Do servlet initialization here. This 

specialii^es the irutQ method in GenericServlet. 

Parameters: 

config - servlet configuration information. . 
Throws: ServletException 

a problem occurred during the initialization of the servlet. 
Overrides: 

init in class GenericServlet 

•log 

public void log (String msg) 
Overrides: 

log in class GenericServlet 
•setSessionMgrState 

public synchronized void setSessionMgrState (int newState) 
•trace 

public void trace (String msg) 
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Class muEtiservapp2servlet.Applicationinteiface 



Ob j ect 

I 

+ RemoteOb j ect 

I ■ . 

+ RemoteServer 

I 

+ UnicastRemoteOb j ect 

+ 

multiserv.applservlet .Applicationlnterface 

public abstract class Applicationlnterface 
extends UnicastRemoteObjea 
implements SessionObsen'Cr 

Encapsulates the application dependent operations which arc invoked from the 
RequestHandler class . 

CoffsPmcPor iMde^ 

^rnultiserv'.applsenletApplicationlnterfacc Q 

MePffod IftdeK 

•accessDenied (String, HttpServletRequest, FitpServletResponse) 

Called when a received request does not contain a valid session id. 
» a uthe ntic a te Us e r (String. String, PfapServletRequest) 

Authenticate the user using a user id and password combination. 
> chninRequest (String, FfepServletRequest, PfepServletResponse) 

Method to forward a URL to another servlet. 
•checkAccess (HttpServletRequest) 

Check the HTTP request data and decide if access should be allowed 
» db_c rPor (HttpServletRequesL PitpServletResponse) 

A database error has occurred 
»db_e rror (PfcpServletRequesL FitpServletResponse, String) 

A database error has occurred 
•destroyO 

Hook to get the Applicationlnterface to brush its teeth before going to 
bed 

^oc_access_crror (FfapServletRequest> HctpServletResponse) 

A document access error has occurred 
»executeOperation (String. String, Session, tfepServletRequest, 
litpServletResponse) 

Called by RequestHandler to execute an application defined operation. 



• getOpe ration (HttpServIetRequest) 

Determine the type of operation to be invoked by the request. 
» getPasswoiid (FfapServletRequest) 

Get a string representing the user's password 
> getPn)pert\ (Stri]i^ 

• getServietParamete r (HttpServletRequest. String) 

Convenience method to extraa a parameter from a litpServletRequesL 
» ge tSc nie tPa ra me te rVa lues (FfctpSeryletRequesL String) 

Convenience method to a multi value parameter from a 

PfepServ^letRequest. 
• getSessionId (FitpServletRequest) 

Extract and retum the session id from the original HTTP request. 
• getTimeZone Q 
> ge tUs e rl d (HttpServIetRequest) 

Get a string representing the user identification 
•init(ApplServlet, String, String) 

Used to initialize the application specific class which implements this 

interface. 

> io_c rpor (FfapServletRequest, HttpServletResponse) 

An io exception has occurred 
•log (String) 

» nfe_e rmr (FfapSeryletRequest, PfepServletResponse) 

A NunJ)erFormatException has occurred 
• nfe e rror (I^tpServletRequesty HttpServletResponse, String) 

A NumberFonmatException has occurred 
•notih:(SessionNotification) 

Override this method to be receive notifications from the Session 

Manager. 

• nsee rror (PfopSeryletRequesL HttpServletResponse) 

A non serializable exception has occurred . 
» posL\uthenticate (String, Session, HttpSen^letRequest, litpServletResponse) 

Post authentication functionality. 
» pos tPe s tro y (HttpSeryletRequest, litpServletResponse) 

Called by the RequestFkndler immediately after the destruction of the 

session object. 

• p ne De s troy (String, Session, tfapServletRequest, HttpServletResponse) 

Called by RequestHandler prior to the destruaion of the session object. 
> re_e mor (HttpSeryletRequest, HtpServletResponse) 

A Remote Exception has occurred 
> $ae_error (FfapServletRequest, PitpServletResponse) 

A Session Access Exception has occurred 
•sendEiTOr(titpServletRequest, String, String, HtpServletResponse) 

General error handlu^ routine. 
• sessionPailure (String, PfepServletRequest) 
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Notify the application that an attempt to access a session using sessionid 
failed 
• trace (String) 

• unkno wnOpe ration fHttpServletRequest, tfepServletResponse) 

An unknown operation has been requested 
# \alidateSession (String. Session, HtpServletRequest) 

Validate the passed session This method can also be used to implement 

any security checks or other checks such as if undesirables are accessing 

the site - such as SPAMMERS 

CoftsPritePors 

^ ^plic ationi nte rf ac e 

public ApplicationlnterfaceO throws RemoteException 
•accessDenied 

public abstract void accessDenied (String operation, 

HttpServletRequest req, 
HttpServletResponse resp) 
Called when a received request does not contain a valid session id. The 
application should return an error/ warning document to the user. 
Parameters: 

operation - the operation being performed 
req - the ordinal HTTP request, 
resp - provides methods to respond to the HTTP server, 
format - the http format to reply in 
•authenticateUser 

public abstract multiserv. sessionmgr .GenericSession 
authenticateUser (String userld, 
String password, 

HttpServletRequest req) throws Exception 

Authenticate the user using a user id and password combination. This 
method can also be used to inplement any pre-session creation 
functionality. 
Parameters: 

userld - The user id string, 
password - The user's password string, 
req - The original HTTP request data. 
Returns: 

A session object containing any initial session data. The returned objea 
must be a sub-class of GenericSession. This will be used to initialize the 
session object in the session manager. If the authentication fails, null is 
returned. 
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chainRequest 

public void chainRequest (String servletUrl, 

HttpServletRequest req, 
HttpServletResponse resp) throws 
ServletException, lOException 

Method to forward a URL to another servlet This is kept as infrastructure 
so that it is easily changed to the most correa way of doing this. 
Paiametets: 

servletUrl - The Servlet URL to which this request should be chained 
rcq - The HTTP reqxiest from the current servlet which is being forwarded 
on. 

resp - provides methods to respond to the HTTP server. 
Throws: ServletException 
Throws: lOException 
See Also: 

getServletParameter 
#checkAccess 

public abstract boolean checkAccess (HttpServletRequest req) 
throws Exception 

Qieck the HTTP request data and decide if access should be allowed An 

application might want to check the IP address or other paramters in the 

request 

Parameters: 

req • Tlie ordinal HTIP request data. 
Returns: 

An indication if access is to be granted 
•db_ertor 

public abstract void db_error (HttpServletRequest req, 

HttpServletResponse resp) 

A database error has occurred 
Parameters: — 

format - the predefined format to reply in 
resp - Ilie HTTP response 
•dbenor 

public abstract void db_error (HttpServletRequest req, 

HttpServletResponse resp, 
String msg) 

A database error has occurred 
Parameters: 

format - the predefined format to reply in 
resp - Hie HTTP response 
destroy 

protected abstract void destroy () 
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Hook to get the Apphcationlnterface to brush its teeth before going to 
bed 

docaccesseiTor 

public abstract void doc_access_error (HttpServletRequest req, 

HttpServletResponse resp) 

A document access error has occurred 
Parameters: 

format - the predefined f omiat to reply in 
resp - The PTTIP response 
•execute Ope ration 

public abstract void executeOperat ion (String operation, 

String sessionid, 
Session session, 
HttpServletRequest req, 
HttpServletResponse resp) 

Called by RequestHandler to execute an application defined operation. 

Parameters: 

operation - Specifies the operation to perfomx Hiis should be one of the 
operation strings returned by getOperation. 
session - An interface to the current session objecL 
sessionid - The session id string for the current session, 
req - The data from the original HTTP request, 
resp - Provides methods for responding to the request. 
•getOperation 

public abstract java. lang. String getOperation {HttpServletRequest 
req) 

Determine the type of operation to be invoked by the request. Note that 

session creation and session destruction requests are indicated by the 

operation strings defined by RequestHandler.CREATE and 

RequestHandlerX)ESTROY respectively. 

Parameters: 

req • ITie HTTP request. 

Returns: 

A string describing the operation to carry out. 
•getPassword 

public abstract java. lang. String getPassword (HttpServletRequest 
req) 

Get a string representing the users password 
Parameters: 

req - The original HTTP request data. 
Returns: 

A string containing the password. 
getProperty 
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public java.lang. String getProperty (String propName) 
getServdetPaiameter 

public java. lang. String getServlet Parameter {HttpServletRequest 
req, 

String parmName) 

throws ServletException, lOException 

Convenience method to extract a parameter from a FfctpServletRequest. 

The method first checks to see if the parameter came from another servlet 

by trying to extract from the request usir^ getAttributeQ. If this fails it 

uses getParameter to extract the parameter. This order of checking means 

that a calling servlet can override parameters. 

Parameters: 

req - The HTTP request 

parmName - The name of the parameter to extract 
Returns: 

The value of the parameter or null if not found 
Throws: ServletException 
Throws: lOException 
See Also: 

getServletParameter 
• getServietParameterValues 

public java. lang. St ring [] 

getServietParameterValues (HttpServletRequest req, 

String 

parmName) throws ServletException, lOException 

Convenience method to a multi value parameter from a 

HttpServletRequest. The method fii^t checks to see if the parameter came 

from another servlet by trying to extract from the request using 

getAttributeQ. If this fails it uses getParameterValues to extract the 

parameter. This order of checking means that a calling servlet can override 

parameters. The caller must be aware if the parameter is a multi value 

parameter. 

Parameters: 

req - The HTTP request 

parmName - The name of the parameter to extract 
Returns: 

The value of the parameter or null if not found 
Throws: ServletException 
Throws: lOException 
See Also: 

getServletParameter 
getSessionId 
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public abstract java . lang. String getSessionId (HttpServletRequest 
reg) throws Exception 

Extract and return the session id from the original HTTP request. 

Parameters: 

req - the original HTIP request 
Returns: 

the session id associated with the request. 
•getTimeZone 

protected java .util .Time Zone getTimeZone ( ) 
•getUserld 

public abstract java . lang . String getUserld (HttpServletRequest. 
req) 

Get a string representing the user identification 
Parameters: 

req - The original HTTP request data. 
Returns: 

A string containing the user id 

•init 

public void init ( ApplServlet applServlet, 
String manage rName, 

String rmiHost) throws ServletException, 

lOException 

Used to initialize the application specific class which implements this 
interface. The servlet configuration is passed in so that the servlet 
environment is available to the application code. 
Parameters: 

applServlet - The Servlet instance which owns this Application! nterf ace 
instance. 

managerName - The name of the session manager instance to map. 
rmihost - The host on which the registry is running 
•ioerror 

public abstract void io_error (HttpServletRequest req, 

HttpServletResponse resp) 

An io exception has occurred 
Parameters: 

format - the predefined format to reply in 
resp - The HTTP response 

•log 

public void log {String message) 
•nfeerror 

public abstract void nfe_error (HttpServletRequest req, 

HttpServletResponse resp) 
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A NumberFormatExceprion has occurred 
Parameters: 

format - the predefined format to reply in 
resp - The HTTP response 
•nfeenor 

public abstract void nf e_error (HttpServletRequest req, 

HttpServletResponse resp, 
String msg) 
A NumberFormatException has occurred 
Parameters: 

format - the predefined format to reply in 

resp - The HH P response 

msg - Additional info to be displayed 

• notify 

public void notify ( SessionNot if ication nofn) 

Override this method to be receive notifications from the Session 

Manager. 

Parameters: 

nofn - Interface which accesses notification information, 
•nseerror 

piiblic abstract void nse_error (HttpServletRequest req, 

HttpServletResponse resp) 

A non serializable exception has occurred 

Parameters: 

format - the predefined format to reply in 
resp - The HTTP response 

• postAudhenticate 

public abstract void postAuthenticate (String sessionid, 

Session initialSession, 

HttpServletRequest req, 

HttpServletResponse resp) 

throws Exception 

Post authentication functionality. This would probably include sending an 

HTML document back to the user. 

Parameters: 

• sessionid - a string identifying the new client session. 
initialSession - the new client Session object initialized with initial data, 
req - the ordinal HTTP request, 
resp - provides methods to respond to the HTTP server. 
•postDestroy 

public abstract void postDestroy (HttpServletRequest req, 

HttpServletResponse resp) 
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Called by the RequestHandler inimediately after the destruction of the 

session object. 

Parameters: 

req - The data from the original HTTP request, 
rcsp - Provides methods for responding to the request. 
•preDestroy 

• 

public abstract void preDestroy (String sessionid, 

Session session, 
HttpServletRequest req, 
HttpServletResponse resp) 

Called by RequestHandler prior to the destruction of the session object. 

Parameters: 

sessionid - The session id string for the current session, 
session - An interface to the associated session object, 
req - The data from the original HTTP request, 
rcsp - Provides methods for responding to the request, 
•rcerror 

public abstract void re_error (HttpServletRequest req, 

HttpServletResponse resp) 
A Remote Exception has occurred 
Parameters: 

format - the predefined format to reply in 
resp - The PTTTP response 
•saeertor 

public abstract void sae_error (HttpServletRequest req, 

HttpServletResponse resp) 
A Session Access Exception has occurred 
Parameters: 

format - the predefined format to reply in 
resp - The HTTP response 
•sendError 

public abstract void sendError (HttpServletRequest req, 

String msgl, 
String msg2 , 

HttpServletResponse resp) 
General error handling routine. This will force the class user to implement 
error messages 
Parameters: 
req - The HTTP request 
msgl - First message to be displayed 
msg2 - Second message to be displayed 
resp - The HTTP response 
sessionFailure 
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pxiblic abstract boolean sessionFailure (String sessionid, 

HttpServletRequest req) 

throws Exception 

Notify the application that an attempt to access a sesssion using sessionid 
failed This could be due to a Bogus sessionid or an expired session. The 
application will decide if a new session is to be created or if accessDeniedQ 
should be called An application might want to log the failure or 
inclement some sort of safeguard such as blocking the IP Address after a 
number of failures. 
Parameters: 

req - The or^al Hi I P request data. 

sessionid - TTie session id string for the current session. 

Returns: 

If true a new session will be created 

•trace 

public void trace (String message) 
• unknownOpe ration 

public abstract void xinknownOperat ion (HttpServletRequest req, 

HttpServletResponse resp) 

An unknown operation has been requested 

Parameters: 

format - the predefined format to reply in 
resp - The HllP response 
•validateSession 

public abstract boolean validateSession (String sessionid, 

Session session, 
HttpServletRequest req) 

throws Exception 

Validate the passed session This method can also be used to implement 
any security checks or other checks such as if undesirables are accessing 
die site - such as SPAMMERS 
Parameters: 

session - The session to validate, 
req - The original HTTP request data. 
Retums: 

An indication if the session is valid 
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Class muKiservapplservletRequestHandler 



Object 
I 

+ multiserv.applservlet .RequestHandler 

public class RequestHandler 

extends Object 

A RequestHandler instance is created for each HTTP request received by the 
Application Serv^let. 

yariakte (Mde^ 

^ CREATE 

The predefined operation types which can be executed by 

RequestHandler. 
^ DESTROY 
•a ppllnterface 

An instance of an application specific class which implements the 

Applicationlnterface 
♦ inanagerName 

The name of the remote Session Manager being used 
•operation 

Shows which operation this thread is executing 
• request 

Holds the data from the original HTTP request 
• response 

Provides methods for responding to the request 
• rmiHost 

The hostname of the RMI registry 
•seniet 

The parent Servlet instance which created this RequestHandler 

CoffsPrucPor //fdsK 

^ multiserv.appls€rvietReque$tHandler (String. String, ApplServlet, 
Applicationlnterface, HttpServ^letRequest, HttpServletResponse) 
The constructor. 

MePffod IfideK 

•handle 0 

The method which implements the request handling functionality. 
• scssionMgr Q 
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o sessionObjName (String) 

Constructs the session objea name given the session id 




©CREATE 



piiblic static final java . lang. String CREATE 

The predefined operation types which can be executed by 
RequestHandler. All other operation types are application dependent and 
must be implemented using Applicationlnterface (or extension thereof) 

O DESTROY 

public static final java . lang. String DESTROY 

Qappllnterface 

protected mult iserv.applservlet .Applicationlnterface 
appllnterf ace 

An instance of an application specific class vAnch implements the 

Applicationlnterface 
O manage iName 

protected java. lang. St ring managerName 

The name of the remote Session Manager being used 
O operation 

protected java . lang . String operation 

Shows which operation this thread is executing 
O request 

protected javax. servlet .http.HttpServletRequest request 

Holds the data from the original HTTP request 
Orcsponse 

protected javax. servlet .http .HttpServletResponse response 

Provides methods for responding to the request 
OnniHost 

protected java . lang . String rmiHost 

The hosmame of the RMI registry 
Oser\iet 

protected multiserv.applservlet .ApplServlet servlet 

The parent Servlet instance which created this RequestHandler 

RequestHandler 

public RequestHandler (String mgrName, 
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string rmihost, 
ApplServlet applServlet, 
Applicationlnterf ace appl, 
HttpServletRequest req, 
HttpServletResponse resp) throws 
RemoteException/ Malf ormedURLException, NotBoundException 

The constructor. Initializes the instances data members. 

Parameters: 

mgrName - The name of the session manager instance to map. 

rmihost - The host on which the registry is running 

applServlet - The parent ApplServlet instance. 

appl - Hie application specifics 

req - The request data from the HTTP server. 

resp - Provides methods for responding to the request. 

Throws: RemoteException 

if registry could not be contacted. 

Throws: NotBoundException 

if SessionMgr is not currently bound. 

•handle 

public void handle {) 

The method which implements the request handling functionality. This 
method processes requests and invokes the appropriate application level 
methods in Applicationlnterface. 

•sessionMgr 

protected multiserv. sessionmgr. SessionMgr sessionMgrO throws 
NotBoundException, RemoteException, Malf ormedURLException 

• s e s s ionOb jName 

protected java ..lang. String sessionObj Name (String sid) 
Constmcts the session object name given the session id. 
Parameters: 

sid - the session id string for the object 
Returns: 

a string containing the session object name or the empty string if sid is 
null. 
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Class muttiservapplservleLSessionTable 



Object 



+ Dictionary 



+ Hashtable 



+ multiserv.applservlet .SessionTable 



public class SessionTable 
extends Hashtable 

A map containing the remote session object interfaces. Each interface is keyed 
using it's associated session id string. 



ConsPrtiePor /ftdsK 



^ multiscn^anplscnieLSessionTable n 



♦ getSession (String) 

Retrieve a Session interface using the associated session id string. 
• putSess ion (Session. String) 

Insert a Session interface into the map using the associated session id as 

the key. 



• getSession 

public multiserv. sessionmgr. Session getSession (String sessionid) 
Retrieve a Session interface using the associated session id string. 
Parameters: 

sessionid - The session id string. 
Returns: 

The Session interface keyed to the given session id or null if the key is 
invalid- 
putSession 

public void putSession ( Ses sion sess, 




SessionTable 



public SessionTable ( ) 
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string sessionid) 
Insert a Session interface into the map using the associated session id as 
the key. 
Parameters: 

sess - The remote session object interface, 
sessionid - The session id string. 
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package multisenuibmgr 

Class Itidey^ 

• JdbcConnection 

• JdbcConnectionBrQker2 

• JdbcConnectionFactorv 

• JdbcObject 

• JdbcVendor 

• TableCache 

• Timing 

• JdbcException 
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Class multiserv.dbmgr.JdbcConnection 

Object 
I 

+ mul tiserv . dbmgr . JdhcConnection 

public abstract class JdbcCoiinection 

extends Object 

YariaMe iMdey^ 

•debug 

CoMsPrucPor IndeK 

^multisen^dbmgrJdbcConnection Q 

Default constructor only used for JdbcCormectionFactory 
^ multiser\\dbmgr,JdbcConnection (String. String, String) 

•Connect(String, String, String) 

• Initialize Q 

• clearWaming sQ 

•cjoseO 

• c reate State me nt Q 

• getConnection Q 

•getlnstance (String, String, String) 

• gctWamings Q 

• is Closed 0 

•toStnngO 

•debug 

public static boolean debug 

CoflsPtHcPors 

-^JdbcConnection 

public JdbcConnection ( ) 

Default constructor only used for JdbcConnectionFactory 
-^JdbcConnection 
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protected JdbcConnect ion (String URL, 

String username, 

String password) throws JdbcException 

•Connect 

pxiblic boolean Connect (String URL, 

String usemame, 
String password) 

•initialize 

protected abstract void Initialize () throws JdbcException 
•clearWamings 

public void clearWamings ( ) throws SQLException 
•close 

public void close ( ) throws SQLException 
•cieateStatement 

public java.isql. Statement createStatement () throws SQLException 
•getConnection 

public java.sql. Connect ion getConnection ( ) 
•getlnstance 

public abstract multiserv.dbmgr .JdbcConnect ion 

getlnstance (String URL, String username , String password) throws 

JdbcException 

•getWamings 

public java.sql.SQLWarning getwarnings ( ) throws SQLException. 
•isQosed 

public boolean isClosedO throws SQLException 
•toString 

public java.lang. String toString () 
Overrides: 

toString in class Object 
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Class multiserv.dbmgrJclbcConnectionBroker2 

Object 
I 

+ mul tiserv . dbmgr . JdbcConnectionBroker2 

public class JdbcConnectionBn)ker2 

extends Object 
implements Runnable 

JdbcConnectionBroker2 A servlet-based broker for database connections. Creates 

and manages a pool of database connections. 

Vereion: 

1.07 9/19/98 
Authon 

Marc A Mnich 



CoMsPrucPor 

^ iTiultiserv\dbmgrJdbcConncctionBn)ker2 (String, String, String, String, 
JdbcConnection, int, int, String, double) 

Creates a new Connection Broker 

dbDriven JDBC driver. 

MeP^od lftde\ 

•destroyO 

Shuts down the housekeeping thread and closes all connections in the 
pool. 

• free Connection QdbcConnection) 

Frees a connection. 
•getAge QdbcConnection) 

Returns the age of a connection - the time since it was handed out to an 

application. 
• getConncction O 

This class hands out the connections in round- robin order. 
♦ idOfConnection JdbcConnection) 

Retums the local JDBC ID for a connection. 
• interrupt O 

A hook for future expansion. 
•ndeaseQ 

Release was method used in previous Connection Pool manager 

•runO 

Housekeeping thread. 
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CoftsPrucpors 

'^JdbcConnectionBiDker2 

piiblic JdbcConnectionBroker2 (String dbDriver, 

String dbServer, 
String dbLogin, 
String dbPassword, 
JdbcConnec t ion connection, 
int minConns, 
int maxConns, 
String logFileString, 
double maxConnTime ) throws 

lOException 

Creates a new Connection Broker 

dbDriver JDBC driver, e.g. 'oracle.jdbc.driver.OracleDriver' 

dbServen JDBC connect string, e.g. 

)dbc:oracle:thin:@203.92.21.109:1526:on:r 

dbLogin: Database login name. e.g. 'Scott* 

dbPassword: Database password, e.g. Tiger' 

minConns: Minimtim number of connections to start with. 

maxConns: Maximum number of connections in dynamic pool. 

logFileString: Absolute path name for log file. e.g. 'c:\\temp\\m)4og.log' 

maxConnTime: Time in days between connection resets. (Reset does a 

basic cleanup) 

M^Pfiods 

•destroy 

public void destroy () 

Shuts down the housekeeping thread and closes all connections in the 
pool. Call this method from the destroyO method of the servlet. 

•freeConnection 

public java. lang.String freeConnection ( JdbcConnection conn) 
Frees a cormection. Replaces connection back into the main pool for 
resuse. 

•getAge 

public long getAge ( JdbcConnection conn) 

Returns the age of a connection - the time since it was handed out to an 

application, 
•getConnection 

public multiserv.dbmgr. JdbcConnection getConnection ( ) 

This class hands out the connections in round- robin order. This prevents a 
faulty connection from locking up an application entirely. A browser 
refresh' will get the next connection while the faulty cormection is cleaned 
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up by the housekeeping thread. If the min number of threads are ever 
exhausted, new threads are added up the the max thread count. Finally, if 
all threads are in use, this method waits 2 seconds and tries again, up to ten 
times. After that, it returns a null. 
•idOfConnection 

public int idOfConnection ( JdbcConnect ion conn) 

Returns the local JDBC ID for a connection, 
•interrupt 

public void interrupt () 

A hook for future expansion. Currently it is used to interrupt the housekeeping 

thread, 
•release 

public void release () 

Release was method used in previous Connection Pool manager 

•run 

public void run() 

Housekeeping thread. Runs in the bacl^round with low CPU overhead. 
Connections are checked for warnings and closure and are periodically 
restarted. This thread is a catchall for corrupted connections and prevents 
the buildup of open cursors. (Open cursors result when the application 
fails to close a Statement). This method acts as fault tolerance for bad 
connection/ statement programming. 
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Class multiserv.dbmgrJdbcConnectionFactory 

Object 

. I ■ 

+ multiserv. dbmgr . JdbcConnec t ionFac t ory 

public class JdbcConnectionFactoiy 

extends Object 

Constructor IndeK 

^ multisei\^.dbmgrJdbcCbnnecrionFactory (JdbcConnection, String, String, 
String) 

Metffod IndiK 

• getConnection Q 

Constructors 

-^JdbcConnectionFactoiy 

public JdbcConnectionFactory ( JdbcConnec t ion connection, 

String URL, 
String username, 
String password) 

•getConnection 

public mult iserv. dbmgr ;JdbcConnection getConnection ( ) throws 

JdbcException 
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All Packages Class Hierarchy This Package Previous Next 



Index 



Class multiserv.dbmgrJdbcObject 



Object 
I 

+ multiserv . dbmgr . JdbcObj ect 



public class JdbcObject 
extends Objca 

The base for a JdbcObjccL When specifying the column names the tableld, if used, must be specified as the first column as 
tabldd. E.g. For a table called Users and there is an id column it mxist be specified as the first column as Uscrsid 



•COLUMNS 

• COLUMNS^INSERT 

•DEBUG 

• INSERTS 

• UPDATES 

• VALUES 

• connect 

•PJ 

•p_sAil 

•p.sByld 

• psDe lcie 

•p s Insert 

• psMaxld 

• pii Update 

•ps U pdate Check 

CoMsPrticPor IttdeK 

^ multisen-.dbmgr.JdbcOb j ect (Connection. String, SiringD, intQ, intQ) 

• Delete (long) 
•Execute 0 
•GeiO 
•GciOong) 
•Ln5.ejt(String[]) 

•Qut'O'O 
•QuenAlJO 
•1 jibleN ame Q 
•Uiidate(long, StringQ) 
•U pd.iteCheck (lor^, long, StringQ) 
•U p date Row (String 
•g etO>lumnN3me s Q 
•g eiCo l umnSlring (int) 

Generate a string coniainirig the column names given a particular operation type. 
•U^^^^£^-5i y'llui^'JKls 0 

•i;cU<*n\'(RcsultSct, RcsukSetMetaData» ini) 

yariai^les 

COLUMNS 
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protected static final int COLUMNS 
O COLUMNSJNSERT 

protected static final int COLUiyiNS_INSERT 

•debug 

public static boolean DEBUG 

•inserts 

protected static final int INSERTS 
•updates 

protected static final int UPDATES 
•values 

protected static final int VALUES 
• connect 

protected java. sql .Connection connect 



protected j ava . sql . PreparedStatement ps 

• psAU 

protected java . sql . PreparedStatement psAll 

• psByld 

protected java . sql . PreparedStatement psByld 

• ps Delete 

protected java . sql . PreparedStatement psDelete 

• psinscrt 

protected java . sql . PreparedStatement psinsert 

• psMaxId 

protected j ava . sql . PreparedStatement psMaxId 

• ps Update 

protected java . sql . PreparedStatement psUpdate 

• psUpdateCheck 

protected j ava . sql . PreparedStatement psUpdateCheck 



ps 




'^JdbcObject 



public JdbcObject (Connection connect, 



String table, 

String [ ) columnNames , 

int columnLength, 

int columnTypes) throws JdbcExce pt ion 
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3 3~i 



• Delete 

public long Delete {long id) throws JdbcException 

• Execute 

public long Execute () throws JdbcException 
•Get 

public java.util.Hashtable Get{) throws JdbcException 
•Get 

public java .util .Hashtable Get (long lid) throws JdbcException . 

• inseit 

public long Insert (String [] row) throws JdbcException 

• Oueiy 

public java. util .Vector Query () throws JdbcException 

• OueiyAIl 

public java. util. Vector QueryAllO throws JdbcException 
•TableName 

public java. lang. St ring TableName () 



nJ •Update 

y| public long Update (long id, 

.CSS, 

\^ 



String [] row) throws JdbcException 

• UpdateCheck 

public long UpdateCheck (long id, 

long checkid; 
String [] row) throws JdbcException 

• updateRow 

public long UpdateRow (String [] row) throws JdbcException 

• getColumnNames 

public java. lang. String [] getColumnNames ( ) 

• getColumnString 

public java . lang. String getColumnString (int iType) 

Generate a string containing the column nanics given a particular operation type. Valid operation types arc* ' 

COLUMNS 

All of the columns 

OOLUMNS_INSERT 

Columns for an insert. Note that this will not include the tablcid column if JdbcVendor.SUPPORT_ID is 

turned on 

UPDATES 

Columns for an update. Note that this will not include the tableld column if JdbcVendor.SUPPORT_ID is 

turned on 

VALUES 

Columns for a VALUES clause of an INSERT statement. Note that this will not include the tableld column if 
JdbcVendor.SUPPORT_ID is turned on 



108 



Paiameteis: 

iTypc - Indicate the opcraiipn type for vAuch the column string is being generated 
gctColunuiTypcs 

public int[] getColumnTypes ( ) 
© gctRow 

public java.util.Hashtable getRow(ResultSet results, 

ResultSetMetaData meta, 
int cols) 



All Packages Class Hierarchy This Package Previous Next 
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Index 



Class multiserv.dbmgrJdbcVendor 



Obj ect 

I 

+ multiserv.dbmgr.Jdbc Vendor • 



public class Jdbc Vendor 
extends Objca 

All of the vendor specific stuff goes in here. Things like supporting an automatically incrcnienting row id colunin. Edit this 
file and recompile ... yuk! 



YariaMe lude^ 

> DUP INDEX 
»DUP_ VALUE 

INFORMIX When inserting a row and a unique column constraint is violated this is the error code returned in 
getErrorOxicO from the SQLExccption 
•SmiQRTJLD 

Some call it SERIAL (eg Infonnix), some call it IDENTITY others just don't have it. 

CoftBprucPor Ifidey^^ 

^m u li is c n.d b m g I'.j d b \ 'e n do rQ 

» duplicatelnde.\ (SQLExccption) 

»<i ctld (PreparedStaiement) 

* k no wnE rmr (SQLExccption) 

^ et Loo kModc W'a it (Conneaion. int) 

• OLfPJNDEX 

public static int DUP_INDEX 

•dup_value 

public static int DUP_VALUE 

INFORMIX When inserting a row and a unique column constraint is violated this is the error code returned in 
getErrorCodeO from the SQLExccption 

• support JO 

public static boolean SUPPORT_ID 

Some call it SERIAL (eg Informix), some call it IDENTITY others just don't have it. Its a column which 
automatically creates a serial id for a row, Posigres doesn't have it but come to thing of it there is another son of 
Id for a row - the details escape me at the moment but that could be an option in the Postgres rather than the 
getNextldQ method 

Cotfspruepors 

'^JdbcVendor 
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public JdbcVendor { ) 
^duplicatelndex 

public. Static boolean duplicatelndex (SQLException e) 
•gctid 

public static long getId(PreparedStatement pStmt) throws 

SQLException 

^knownEmor 

public static boolean knownError (SQLException e) 
• sctLockModcWait 

public static boolean setLockModeWait (Connection connect, 

int seconds) throws 

JdbcException 
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Class multiserv.dbmgr.TableCache 



Object 

I 

+ - - 



+ mult iserv . dbmgr . TableCache 



public abstratt class TableCache 
extends Cache 

This class provides a base class for caching a JdbcObjea. Subclasses simply need to override the 

getJdbcObjea(Conneaion) method 

Version: 

$Id: TableCache.java,v 1.4 1999/12/03 19:42:22 peter Exp $ 

See Also: 

getJdbcObjea; Oche 



CoMsPrucPor Itidey^ 

^ muhiserv.dbmgr.TablcC^^c heQ 
^ muliisen.dbmg r.TableCiche QdbcConncaionBroker2) 
^ muliise iv.dbmg r.Ta hIe Cic he (JdbcConneaionBfx)ker2, long) 

MePffod Ifide^ 

•g^I dbcObiea (Conneaion) 

This method should be defined in the sub class, 
»get Ro\\ (long) 

Retrieve a row from the cached table by specifying the row id 
»po pulnte O 

The database table is populated by using a JDBC objca created by gctJdbcObjca. 
•reinitialize 0 

Simply calls populate, 
» <; e tCo nnM a nj gc r JdbcConnectionB roker2) 

Cottsprfiepors 

^TableCache 

public TableCache { ) 
-^Table Cache 

public TableCache ( JdbcConnectionBroker2 connMgr) throws 
lOException 

Paiamcteis: 

connMgr - - The JDBC Cpnneaion broker 
^TableCache 

public TableCache ( JdbcConne ctionBro ker2 connMgr, 

long sees) throws lOException 

Parameters: 

connMgr - - The JDBC Conncaion broker 
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sees - - The cache is rcpopulated every sas seconds 



• getJdbcObject 

protected abstract multiserv.dbmgr . JdbcObject 
getJdbcObject (Connection connect) throws JdbcException 

This method should be defined in the sub class. It should just create an instance of a subclasses JdbcObject^ 

passir^ it connect. 

Paiameteis: 

connea - Database connection. 

©getRow 

pxiblic java.util .Hashtable getRowdong id) throws CacheException 
• Retrieve a row from the cached table by specifying the row id 
Paiameteis: 

id - The id of the row to be retrieved. 
Returns: 

Hashtable as returned by a JdbcObjea single row query. 
Throws: Cache Excepi ion 
- row not found in Cache 
^populate 

public void populate () 

The database table is populated by using a JDBC objea created by getJdbcObjea. 
Ovenides: 

popubte in class Ciche 
^reinitialize 

public void reinitialize ( ) 
Ovenides: 

rt-iniii. iiizc in class Cwhe 
^ repopulate 

public void repopulate ( ) 

Simply calls popxilate. Obviously want to have a long cache check time. Could put in some sort of check to see 

when the table was last i^xlated but this would be some sort of Vendor specific hook. 

Overrides: 

r<:-po pulaie in class Ciche 
© setConnManage r 

public void setConnManager ( JdbcConnectionBroker2 connMgr) 
Parameteis: 

connMgr - - The JDBC Connection broker 
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Class multiserv.dbmgr.Timing 

Object 
I 

+ mul t iserv . dbmgr . Timing 

public class Timing 
extends Object 

CortsPruePor My, 

^mulriserv.dbmgr.Timing Q 

J^ePffod Iffdeyi, 

• LogTiming (String) 

Cortsprucpors 

^Timing 

public Timing (} 

M^P^ods 

•LogTiming 

public void LogTiming {String szMessage) 
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Class multiserv.dbmgrJdbcException 



Object 

. I 

+ Throwable 

I 

+ Exception 



+ SQLException 

I 

+ mul t iserv . dbmgr . JdbcExcept ion 



public class JdbcException 

extends SQLException 



CoffsPrHCpor 

^ multiserv.dbmgrJdbcExceprion O 
^ multiserv.dbmgrJdbcExccprion (String;) 
^ multJserv^dbmgrJdbcException (Stxing, String, int) 

/J{ep/fod /ffdex. 

» is Duplicate Value Q 

Coffsprucpors 

-^JdbcException 

public JdbcException ( ) 

^JdbcException 

public JdbcExcept iontSt ring s) 
^JdbcException 

public JdbcException (String message, 

String state, 
int error) 

M^phods 

• is Duplicate Value 

public boolean isDuplicateValue ( ) 
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package muKiserv-sessionrngr 

Itjperface Irtdey, 

• Session 

• SessionMgr 

• SessionNotificaiion 

• SessionObseiver 

• SessionTag s 

class Ifldeyt^ 

• GenericSession 

• NotificationData 

• Obser\^erA4ap 

• SessionExpirer 

• SessionldFactoiy 

• Sessionlmpl 

• SessioaMap 

• SessionA^grConnection 

• SessionA4grImpl 

• SessionMgi'ShutdowTi 

• SocketHandler 

t y^ce/^Pioff Index, 

• SessionAccessException 
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Interface multiserv.sessionmgr.Session 



public abstract interface Session 
extends Remote 

The Session remote interface is used to access the Sessionlmpl objects within the 
session manner. 

MePfiod IrtdeK 

♦expire 0 

Mark this object as expired, 
• ge tPouble (String) 

Get the value of a double precision floating point field within the 

associated Sessionlrrpl instance. 
• gctInt (String) 

Get the value of an integer type field within the associated Sessionlmpl 

instance. 
♦ getLastAccessed Q 

Get the time at which this instance was last accessed. 
•getLong(String) 

Get the value of a long integer field within the associated Sessionlmpl 

instance. 
•getObject(String) 

Get the value of a field within the associated Sessionlmpl instance. 
• hasExpired l) 

Determine if this object has expired 
•setDoubJe (String, double) 

Set the value of a double precision floating point field within the 

associated Sessionlmpl instance. 
•setInt(String, int) — 

Set the value of an integer type field within the associated Sessionlmpl 

instance. 
•setLong(String, long) 

Set the value of a long integer field within the associated Sessionlmpl 

instance. 
•setObject(String, Object) 

Set the value of a field within the associated Sessionlmpl instance. 
•touchO 

Mark the time when this object was last accessed as now. 
expire 
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public abstract void expire () throws RemoteException 
Mark this object as expired 
getDouble 

public abstract double getDouble (String fieldName) throws 
SessionAccessException , RemoteException 

Get the value of a double precision floating point field within the 

associated Sessionlmpl instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
Returns: 

The value of the field 
Throws: SessionAccessException 
Field doesn*t exist or is private. 
Throws: RemoteException 
Communications error, 
•getint 

public abstract int getint (String fieldName) throws 
SessionAccessException , RemoteException 

Get the value of an integer type field within the associated Sessionlmpl 

instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
Returns: 

The value of the field. 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Communications error. 
•getLastAccessed 

public abstract long getLastAccessed ( ) .throws RemoteException 
Get the time at which this instance was last accessed. 
Returns: 

the time in milliseconds since EPOCH when this object was last accessed. 
•getLong 

public abstract long getLong (String fieldName) throws 
S essionAccessExceptio n , RemoteException 

Get the value of a long integer field within the associated Sessionlmpl 

instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
Returns: 

The value of the field. 

Throws: SessionAccessException 
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Field doesn't exist or is private. 
Throws: RemoteException 
Communications error. 
•getObject 

public abstract java.lang. Object getObject (String fieldName) 
throws SessionAccessExcept ion , RemoteException, 
NotSerializableException 

Get the value of a field within the associated Sessionlmpl instance. The 

field type must be an extension of Objea and must also implement the 

Serializable interface. 

Pammeters: 

fieldName - A string specifying the name of the field to set. 
Returns: 

The value of the field 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Communications error. 
Throws: NotSerializableException 
value doesn't implement Serializable 
•hasExpiied 

pxiblic abstract boolean hasExpiredO throws RemoteException 
Determine if this object has expired 
Returns: 

true if the object has expired, false otherwise. 
•setDouble 

public abstract void setDouble (String fieldName, 

double value) throws 
SessionAccessException , RemoteException 

Set the value of a double precision floating point field within the 

associated Sessionlmpl instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Communications error, 
•setint 

public abstract void setint (String fieldName, 

int value) throws 
SessionAccessException , RemoteException 
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Set the value of an integer type field within the associated Sessionlmpl 

instance. 

Parameters: 

f ieldName - A string specifying the name of the field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Communications error. 
•setLong 

public abstract void setLong (String f ieldName, 

long value) throws 
SessionAccessException , RemoteException 

Set the value of a long integer field within the associated Sessionlmpl 

instance. 

Parameters: 

f ieldName - A string specifying the name of the field to set, 
value - Hie value to set the field to. 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Communications error. 
•setObject 

public abstract void setObject (String f ieldName, 

Object value) throws 
SessionAccessException ', RemoteException, 
NotSerializableException 

Set the value of a field within the associated Sessionlmpl instance. The 

field type must be an extension of Object and must also implement the 

Serializable interface. 

Parameters: 

f ieldName - A string specifying the name of the field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
Field doesn't exist or is private. 
Throws: RemoteException 
Communications error. 
Throws: NotSerializableException 
value doesn't implement Serializable 
•touch 

public abstract void touch () throws RemoteException 
Mark the time when this object was last accessed as now. 
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Interface multiserv.sessionmgr.SessionMgr 



public abstxact interface SessionMgr 
extends Remote 

Hie SessionMgr remote interface is used to control the session manager. 



•c los e Sc s s ion (String) 

Remove an existing Sessionlmpl object from the session manager. 
• initScssion (Session) 

Create a new Sessionlmpl object within the session manager. 
•ne gister (String) 

A remote entity registers interest in events taking place within the session 

manager by calling this method 
• sessionldList Q 

Return an array containing all the current Session object identifiers, 
• shutdown (String) 

A remote entity informs the Session Manager that it is prepared to have 

the Manager shutdown operations. 
•unregister(String) 

A remote entity calls this method to stop further notifications being sent 

by the session manager. 



•closeSession 

public abstract void closeSession (String • sessionid) throws 
RemoteException, Malf ormedURLException, NotBoundException 

Remove an existing Sessionlmpl object from the session manager. 

Parameters: 

sessionid - A string which identifies the session to be removed. 

Throws: RemoteException 

if some communication failure occurs. 

Throws: NotBoundException 

the session which is being closed does not have it's interface bound to the 
RMI registry. 
• initSession 

public abstract java . lang . String initSession ( Session session) 
throws RemoteException, Malf ormedURLException, 
Sessio nAccessException , NotSerializableException 

Create a new Sessionlmpl object within the session manager. 

Parameters: 
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session - Contains the initial session data. 
Returns: 

A string used to identify the new session in subsequent accesses to the 
session manager. 
Throws: RemoteException 
if some communication failure occurs, 
•register 

public abstract void register {String id) throws RemoteException 
A remote entity registers interest in events taking place within the session 
manager by calling this method After registering the session manager can 
notify the entity via the Servlet's SessionObserver interface. 
Parameters: 

id - A unique string identifying the registering entity 
Throws: RemoteException 
if some communication failure occurs. 
•sessionldList 

public abstract java.util .Vector sessionldList ( ) throws 
RemoteException 

Return an array containing all the current Session object identifiers. 

Returns: 

A Vector instance containing the Session object id's. 
Throws: RemoteException 
if some communication failure occurs, 
•shutdown 

public abstract void shutdown (String id) throws RemoteException 
A remote entity informs the Session Manager that it is prepared to have 
the Manager shutdown operations. The Session Manager will shutdown 
operation as soon as it receives shutdown notifications from all registered 
entities. 
Parameters: 

id - A unique string identifying the entity 
Throws: RemoteException 
if some communication failure occurs, 
•unregister 

public abstract void unregister {String id) throws 
RemoteException 

A remote entity calls this method to stop furdier notifications being sent 

by the session manager. 

Parameters: 

id - A unique string identifying the entity. 

Throws: RemoteException 

if some communication failure occurs. 
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Intetface 



multiseiv.sessk>nmgr-SessionNotifk^ 

public abstract interface SessionNotification 

Provides the interface through which the Session Manager can transfer 
notification data. Any class which implements this interface must also implement 
interface java.io.Seriali2able. 

yariakle iMdeyi, 

. MANAGE R RE LOAD 
. MANAGER RUNNING 
. MANAGE R SHUTDOWN 
. MANAGE R STOPPING 
. SESSION EXPIRATION 

•rcasonQ 

Returns an integer code representing the reason for the notification. 
♦ scssioiiId O 

Returns a string giving the session id for the Session object which caused 
the notification to be issued 
• sessionObj O 

Returns a reference to a copy of the Session object which this 
NotificationData instance relates to. 

•MANAGER RELOAD 

public static final int MANAGER_RELOAD 
•MANAGERRUNNING 

public static final int MANAGER_RUNNING 
•MANAGER_SHUTDOWN 

public static final int MANAGER_SHUTDOWN 

•MANAGER_STOPPING 

public static final int MANAGER_STOPPING 

•SESSION_EXPIRATION 

public static final int SESSION_EXPIRATION 
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•reason 

public abstract int reason () 

Returns an integer code representing the reason for the notification. In 
general, these integer codes will be application dependent. 

•sessionid 

public abstract java. lang.String sessionldO 

Returns a string giving the session id for the Session object which caused 
the notification to be issued. TTiis will return null if the notification is not 
connected with any Session object. 

•sessionObj 

public abstract multiserv.sessionmgr .Session sessionObj ( ) 
Returns a reference to a copy of the Session object which this 
NotificationData instance relates to. For example, if this is a session expiry 
notification then this method will return a reference to a copy of the 
Session object which was removed from the Session Manager. 
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public abstxaa interface SessionObserver 
extends Remote 

Provides the interface via vAnch the Session Manager can notify remote entities. 

©noti^(SessionNotification) 

Called by the Session Manager to notify the entities \^4uch implement this 
interface. 

•notify 

pxiblic abstract void notify ( SessionNot if icat ion nofn) throws 
Remote Except ion 

Called by the Session Manner to notify the entities which implement this 

interface. 

Parameters: 

nofn - Interface which accesses data relating to the notification. 

Throws: RemoteException 

if some communication failure occurs. 
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Interface multiserv.sessionmgr.SessionTags 



public abstract interface SessionTags 
Defines the constants used for basic sessions 



yariai'le Irtden^ 

.APPL OPERATION 
. BROWSER TAG 
.BROWSER TOKEN 
.COMMENT TOKEN 
.COMPUTER TAG 
.COMPUTER TOKEN 
. CONNECTION_TAG 
.CONNE CTI ON TOKE N 
.COOKIE TAG 
.DATE TOKEN 
.DOCNAME TAG 
.EMAIL TAG 
. END TOKEN 
. GUC TOKEN 
. LC OPT PREFIX 
. LOGIN TAG 
.LOGOUT OP 
.MSGITOKEN 
. MSG2_TOKEN 
.NAME TAG 
.NAME TOKEN 
.OPT PREFIX 
.OP TAG 
.OP TOKEN 
.PASSWORD TAG 
. SESSIONIDTAG 
. SESSIONIDTOKEN 
. SESS_ACriVE_TAG 
. SESS_ID_TAG 
. SESS_IP_ADDR TAG 
. SESS_START_TAG 
. SESSUSERIDTAG 
. SESSUSERTAG 
. SPEEDTAG 
. SPEED TOKEN 
. START TOKEN 
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.STATUS TOKEN 
■TRRMINATE TAG 
■ TIMEOUT TAG 
■TTME OUT TOKEN 
.TIME TOKEN 
.TYPE TAG 
.TYPE TOKEN 
.URL TAG 
.URL TOKEN 
.USERID TAG 

Hie following constants define the HTML tags which are used to identify 
data fields. 
. USERNAME TAG 

•APPL OPERATION 

public static final java.lang. String APPLOPERATION 
•BROWSER TAG 

public static final java. lang. String BROWSER_TAG 
•BROWSER TOKEN 

public static final java. lang. String BROWSERTOKEN 
•COMMENT TOKEN 

public static final java. lang. String COMMENT_TOKEN 
•COMPUTER TAG 

public static final java. lang. String COMPUTER_TAG 
•COMPUTER_TOKEN 

piiblic- static final java. lang. String COMPUTER_TOKEN 
•CONNECriON_TAG 

public static final java. lang. String CONNECTION_TAG 
•CONNECTION TOKEN 

public static final java. lang. String CONNECTIONTOKEN 
•COOKIE TAG 

public static final java. lang. String COOKIE_TAG 
•DATE TOKEN 

public static final j ava . lang . String DATE_TOKE» 
• DOCNAME TAG 

public static final java. lang. String DOCNAME_TAG 
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•EMAIL TAG 



public static final java.lang. String EMAIL_TAG 
•END TOKEN 

public static final java. lang. String END_TOKEN 
•GUC_TOKEN 

public static final java. lang .String GUC_TOKEN 
•LC OPT PREFIX 

public static final java. lang. String LC_OPT_PREFIX 
•LOGINTAG 

public static final java.lang.String LOGIN_TAG 

•LOGOUT OP 

public static final java.lang.String LOGOUT_OP 
•MSGITOKEN 

public static final java.lang.String MSGITOKEN 
•MSG2 TOKEN 

public static final java.lang.String MSG2_TOKEN 
•NAME TAG 

public static final java.lang.String NAME_TAG 
•NAME TOKEN 

public static final java.lang.String NAME_TOKEN 
•OPT PREFIX 

public static final java.lang.String OPT_PREFIX 
•OPTAG 

public static final java.lang.String OP_TAG 
•OPTOKEN 

public static final java.lang.String OP_TOKEN 
•PASSWORD TAG 

public static final java.lang.String PASSWORD_TAG 
•SESSIONID TAG 

public static final java.lang.String SESSIONID_TAG 
•SESSIONID TOKEN 

public static final java.lang.String SESSIONID_TOKEN 
SESS_ACriVE TAG 
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public static final java.lang. String SESS_ACTIVE_TAG 

SESS_ID TAG 

pioblic static final java.lang. St ring SESS_ID_TAG 

•SESS_IP_ADDR_TAG 

public static final java.lang. St ring SESS_IP_ADDR_TAG 

•SESS_START_TAG 

public static final java.lang. St ring SESS_START_TAG 
•SESS_USER_ID_TAG 

public static final java . lang, String SESS_USER_ID_TAG 

•SESS_USER_TAG 

public static final java . lang . String SESS_USER_TAG 

•SPEEDTAG 

public static final java . lang . String SPEED_TAG 

•SPEEDTOKEN 

public static final java . lang. String SPEED_TOKEN 
•STARTTOKEN 

public static final java . lang . String START_TOKEN 

•STATUS_TOKEN 

public static final java . lang . String STATUS_TOKEN 

•TERMINATE TAG 

public static final java . lang . String TERMINATE_TAG 

•TIMEOUTTAG 

public static final java . lang . String TIMEOUT_TAG 

•TIMEOUTTOKEN 

public static final java . lang . String TIMEOUT_TOKEN 

•TIMETOKEN 

public static final java . lang . String TIME_TOKEN 

•TYPETAG 

public static final java . lang . String TYPE_TAG 

•TYPE_TOKEN 

public static final 

•URLTAG 

public static final 
URLTOKEN 



java . lang . String TYPE_TOKEN 
. j ava , lang . String URL_TAG 
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public static final java . lang . String URL_TOKEN 
USERID TAG 



public static final java . lang .String USERID_TAG 

The following constants define the HTML tags which are used to identify 
data fields. TTiis file could possibly be generated automatically fn:>m or 
along with the HTML documents themselves. 

•USERNAMETAG 

piiblic static final java. lang. St ring USERNAME_TAG 
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Class multiservsessionmgr.GeneiicSession 



Object 

I 

+ RemoteOb j ect . 

I 

+ RemoteServer 

1 

+ UnicastRemoteObject 

I 

+ 

multiserv. sessionmgr.GenericSession 



public class GenericSession 
extends UnicastRemoteObject 
implements Session , Serializable, Qoneable 

yariaHe lMde\ 

♦ expired 
•lastAccessed 

CoffsPrucPor Index, 

^ multiserv^sessioiimgnGenericSession Q 

J^ePhod /ffde\ 

♦ cxpine Q 

Mark this object as expired 
•getDouble (String) 

Get the value of a double precision floating point field within the 

associated Sessionlmpl instance. 
• gctInt (String) 

Get the value of an integer type field within the associated Sessionlnpl 

instance. 
• getLastAcccssed O 

Get the time at which this instance was last accessed. 
•getLong(String) 

Get the value of a long integer field within the associated Sessionlmpl 

instance. 
» getObjcct (String) 

Get the value of a field within the associated Sessionlmpl instance. 
• hasExpined Q 

Determine if this object has expired 
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• sessionFailure (Exception) 

General exception handler for the session object 
• scssioiiFailune (String. Exception) 

General exception handler for the session object 
•setDoubje (String, double) 

Set the value of a double precision floating point field within the 

associated Sessionlnyl instance. 
• setInt (String, int) 

Set the value of an integer type field within the associated Sessionln^l 

instance. 
•setLong (String, loi^) 

Set the value of a long integer field within the associated Sessionln^l 

instance. 
• s e tOb je c t (String, Object) 

Set the value of a field within the associated Sessionlmpl instance. 
•touchO 

Mark the time when this object was last accessed as now. 
•expired 

protected boolean expired 

• lastAccessed 

protected long lastAccessed 

Conspruepors 

'^GenericSession 

public GenericSession { ) throws Remote Except ion 
•expire 

public void expire () throws RemoteException 
Mark this objea as expired 

• getDouble 

public double getDouble {String fieldname) throws 
SessiorL^.ccessExce ption 

Get the value of a double precision floating point field within the 

associated Sessionlmpl instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
Returns: 

The value of the field. 

Throws: SessionAccessException 
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if there was a problem accessing the fields value, 
getint 

piiblic int getint (String fieldName) throws 
SessionAccessException 

Get the value of an integer type field within the associated Sessionlmpl 

instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
Returns: 

The value of the field. 
Throws: SessionAccessException 
if there was a problem accessing the fields value. 
• getLastAccessed 

public long getLastAccessed { ) throws RemoteException 
Get the time at which this instance was last accessed 
Returns: 

the time in milliseconds since EPOCH ^en this object was last accessed. 
•getLong 

public long getLong (String fieldName) throws 
SessionAccessException 

Get the value of a long integer field within the associated Sessionlmpl 

instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
Returns: 

The value of the field 
Throws: SessionAccessException 
if there was a problem accessing the fields value. 
•getObject 

public java.lang. Object getObjec.t (String fieldName) throws 
SessionAccessException 

Get the value of a field within the associated Sessionlmpl instance. The 

field type must be an extension of Object and must also implement the 

Serializable interface. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
Returns: 

The value of the field 
Throws: SessionAccessException 
if there was a problem accessing the fields value. 
hasExpired 

public boolean hasExpired () throws RemoteException 
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Determine if this object has expired 
Returns: 

true if the object has expired, false otherwise. 
•sessionFailurc 

protected void sessionFailure (Exception e) throws 
SessioaA.ccessException 

General exception handler for the session object 

Parameters: 

e - the exception which is being handled 
Throws: SessionAccessException 
there was a problem while accessing a field 
•sessionFailurc 

protected void sessionFailure (String fieldName, 

Exception e) throws 

SessionAccessException 

General exception handler for the session object 
Parameters: 

e - the exception which is being handled 
Throws: SessionAccessException 
there was a problem while accessing a field 
•setDouble 

public void setDouble {String fieldName, 

double value) throws 

SessionAccessException 

Set the value of a double precision floating point field within the 

associated Sessionln^l instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
if there was a problem accessing the fields value, 
•setint 

public void setint (String fieldName, 

int value) throws SessionAccessException 
Set the value of an integer type field within the associated Sessionlmpl 
instance. 
Parameters: 

fieldName - A string specifying the name of the field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
if there was a problem accessing the fields value. 
setLong 
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public void setLong (String fieldName, 

long value) throws SessionAccessException 

Set the value of a long integer field within the associated Sessionlmpl 

instance. 

Parameters: 

fieldName - A string specifying the name of the field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
if there was a problem accessing the fields value. 
•setObject 

public void setObject (String fieldName, 

Object value) throws 

SessionAccessException 

Set the value of a field within the associated Sessionln^l instance. The 
field type must be an extension of Object and must also implement the 
Serializable interface. 
Parameters: 

fieldName - A string specifying the name of the field to set. 
value - The value to set the field to. 
Throws: SessionAccessException 
if there was a problem accessing the fields value, 
•touch 

public void touch () throws RemoteException 

Mark the time when this object was last accessed as now. 
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Class multiserv.sessionmgr.NotificationData 

Obj ect 
I 

+ multiserv. sessionmgr .Notif icationData 

public class NotificationData 

extends Object 

implements SessionNotification . Seiializable 

Provides an implementation of the SessionNotification interface 

Cofisprnepor ludey^ 

^ multiserv.sessionmgr.NotificationData (inL String, Session) 
•rcasonQ 

Returns an integer code representing the reason for the notification. 
•sessjonldO 

Returns a string giving the session id for the Session object which caused 
the notification to be issued. 
• sessionObj O 

Returns a reference to a copy of the Session object which this 
NotificationData instance relates to. 

Cortspruepors 

-^NotificationData 

public Notif icationData {int code. 

String id, 
Session sess) 

M^P^ods 

•reason 

public int reason () 

Returns an integer code representing the reason for the notification. In 
general, these integer codes will be application dependent 

•sessionid 

public java.lang. String sessionid {) 

Returns a string giving the session id for the Session object which caused 
the notification to be issued. This will return null if the notification is not 
connected with any Session object. 
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sessionObj 

public multiserv.sessionmgr .Session sessionObj () 

Returns a rcfercnce to a copy of the Session object which this 
Notif icationData instance relates to. For example, if this is a session expiry 
notification then this method will return a reference to a copy of the 
Session object which was removed from the Session Manager. 
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Class multiserv.sessionmgr.Observer1Vlap 



Object 
I 

+ Dictionary 

I 

+ Hashtable 

+ mult iserv . sessionmgr . ObserverMap 

public class ObserverMap 
extends Hashtable 

The ObserverMap class stores the currently actice SessionObserver instances 
within the session manager. 

CoMBpr/iCpor ludey^^ 

^ multis e r\^ s e s s ionmgr. Obs e r\^e rMa p 0 
^ multiserv.scssionmgr.Obscrv^erMap (int) 
^multiserv.$essioningr,Obsen^erMap (int. float) 

^ePkod /f/dex. 

•putObserver(String) 

Insert an observer object within the map using the remote entity id string 

as the key. 
» re move Obs e n^e r (String) 

Remove an observer object from the map. 

Coffsprucpors 

^ObserveiMap 

public ObserverMap ( ) 

^Observe iMap 

public ObserverMap (int capacity) 

-^ObserverMap 

public ObserverMap ( int capacity, 

float loadFactor) 

M^P^ods 

•putObserver 

public void putObserver ( String id) 
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Insert an observer object within the map usii^ the remote entity id string 

as the key. 

Parameters: 

obs - The observer objea to insert in the rnap. It must be implement the 
SessionObserver interface, 
id - The remote entity id string. 
• remove Obs erver 

public void removeObserver (String id) 

Remove an observer object from the map. 
Parameters: 

id - The id string for the observer to remove 
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Class multiserv.sessionmgr.SessionExpirer 



Object 
I 

-Thread 

I 

+ mul t iserv . sessionmgr . SessionExpirer 

public class SessionExpirer 
extends Thread 

A thread object which expires stale session objects within the session manager at 
regular intervals. 

CoMsPrHcPor iMde^ 

^ multi$erv,sessionmgr.SessionExpirer (SessionN^rImpI) 

• haltExpiries Q 
•runO 

Coffsprucpors 

^SessionExpirer 

public SessionExpirer ( SessionMgrlmpl mgr) 

MePifods 

•HaltExpiries 

public void haltExpiries ( ) 

•run 

public void run() 

Overrides: 

mn in class Thread 
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Class muttiservsessionrngrSessionldFactory 

Ob j ect 
I 

+ multiserv.sessionmgr .SessionldFactory 

public class SessionldFactoiy 

extends Object 

CoffsPrucPor lude^ 

^ multiserv.sessionmgnSessionldFactory O 

MePkod IrfdeK 

» createScssionId () 

Creates a randomly generated string with NUMDIG digits, NUMLOWER 
lowercase characters, and NUMUPPER charaaers arranged randomly. 

Cotfsptfiepors 

-^SessionldFactoiy 

public SessionldFactory { ) 

M^phods 

•crcateSessionId 

public static java . lang . String createSessionId { ) 

Creates a randomly generated string with NUMDIG digits, NUMLOWER 
lowercase characters, and NUMUPPER characters arranged randomly. 
Returns: — 
the randomly generated string 
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Class multiserv.sessionmgr.Sessionlmpl 



Object 
I 

+ RemoteObject 

I 

+ RemoteServer 

I 

+ UnicastRemoteOb j ect 

I 

+ GenericSession 

I 

+ 

multiserv. sessionmgr . Sessionlmpl 

public class Sessionlmpl 
extends GenericSession 
in^lements SessionTags 

Contains the application dependent data fields for the session. 

yariaHe ludev^ 

• sessactive 

» sess_ip_addr 

» sess_stait 

•sessjjser . 

The actual Session Object members 
♦ sessuserid 

CoMsPrucPor lude^ 

^ multiserv.sessionmgnSessionlmpl O 

Get a new Sessionlmpl object within the session manager. 
^multisen^sessionmgnSessionImpl (String, Long, BigDecimal, BigDecimal, 
String) 

Get a new Sessionlmpl object within the session manager. 
v multi$erv^sessionmgr.Se$sionImpl (SessiQn) 

Get a new Sessionlmpl object within the session manager. 

Mepffod lnde\ 

# getSession () 

Get a new Sessionlmpl object within the session manager. 
•getSession (String, Long, BigDecimal, BigDecimal, String) 

Get a new Sessionlmpl object within the session manager. 
•getSessjon (Sess ion) 
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© 



Get a new Sessionlmpl object within the session manner. 
Osessactive 

protected java.math.BigDecimal sess_active 
Osessipaddr 

protected j ava . lang . String sess_ip_addr 
Osessstait 

protected java.math.BigDecimal sess_start 

Osessuser 

protected j ava . lang . String sess_user 

The actual Session Object members 
Osessuserid 

protected j ava. lang. Long sess_user_id 



<^ Sessionlmpl 



public Sessionlmpl ( ) throws RemoteException 

Get a new Sessionlmpl object within the session manager. Gives the user 

the chance to override the defavilt session behaviour. 

Returns: 

A string used to identify the new session in subsequent accesses to the 
session manager. 
<^ Sessionlmpl 

public Sessionlmpl (String sess_user. 

Long sess_user_id, 
BigDecimal sess_start, 
BigDecimal sess_active, 

String sess_ip_addr) throws RemoteException 
Get a new Sessionlmpl object within the session manager. Gives the user 
the chance to override the default session behaviour. 
Parameters: 
sess_user - The user 
sess_user_id - The user id 
sess_start - Time session was started 
sess_active - Last time the session was active 
sess_ip_addr - Remote IP Address 
Returns: 

A string used to identify the new session in subsequent accesses to the 
session manager. 
-^Sessionlmpl 



public Sessionlmpl (Session initial) throws RemoteException, 
SessionAccessException , NotSerializableException 

Get a new Sessionlmpl objea within the session manager Gives the user the chance to override the dcfauk 

session behaviour. 

Parameters: 

initial - The initial session 

Returns: 

A string used to identify the new session in subsequent accesses to the session man^^cr 

• getSession 

public static mult iserv. sessionmgr. Sessionlmpl getSession () 
throws RemoteException, SessionAccessException , 
NotSerializableException 

Get a new Sessionlmpl object within the session manager. Gives the user 

the chance to override the default session behaviour. 

Returns: 

A string used to identify the new session in subsequent accesses to the 
session manager. 

• getSession 

public static multiserv . sessionmgr . Sessionlmpl getSession (String 
sess_user, Long sess_user_id, 

BigDecimal sess_start , BigDecimal sess_active. 
String sess_ip_addr) throws RemoteException, 
SessionAccessException , NotSerializableException 

Get a new Sessionlmpl object within the session manager. Gives the user 

the chance to override the default session behaviour. 

Parameters: 

sess user - The user name 

sess_user_id - The user id 

sess_stan; - Time session was started 

sess active - Last time the session was active 

sess_ip_addr - Remote IP Address 

Returns: 

A string used to identify the new session in subsequent accesses to the 
session manager. 

• getSession 

public static multiserv. sessionmgr .Sessionlmpl 
getSession ( Session initial) throws RemoteException, 
SessionAccessExcepti on, NotSerializableException 

Get a new Sessionlmpl object within the session manager. Gives the user 

the chance to override the default session behaviour. 

Parameters: 

session - Contains the initial session data. 
Returns: 
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A strir^ used to identify the new session in subsequent accesses to the 
session manager. 
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Class multiserv.sessionmgr.SessionlVlap 



Object 

+-- -Dictionary 

I 

+ Hashtable 

+ multiserv . sessionmgr . SessionMap 

public class SessionMap 
extends Hashtable 

The SessionMap class stores the currently active Sessionlmpl instances within the 
session manager. 

CoffsPrucPor IttdeK 

^ multiserv.sessionmgr.SessionMap Q 
^ multiserv.sessioningr.SessioiiMap (int) 
^ multi s e rv, s e s s io nmg r. Se s s io iiMa p (int, float) 

^eP/fod /f/dex. 

• getSession (String) 

Retrieve a session object from within the using the specified session id key. 
• putSe$sion (Session, String) 

Insert a session object within the map using the session id string as the 

key. 

• remove Session (String) 

Remove a session object from the map. 

CoHsPrucpors 

^SessionMap 

public SessionMap 0 

^SessionMap 

public SessionMap (int capacity) 

^SessionMap 

public SessionMap {int capacity, 

float loadFactor) 

getSessioh 
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public multiserv.sessionmgr. Session getSession( String sessionid) 
Retrieve a session object from within the using the specified session id key. 
Parameters: 

sessionid - The session id string. 
Returns: 

The session object if the session id is valid otherwise null 
•putSession 

public void putSession ( Session session, 

String sessionid) 
Insert a session objea within the map usii^ the session id string as the 
key. 

Parameters: 

session - Tlie session object to insert in the map. It must be a subclass of 
GenericSession. 

sessionid - The session id string. 
• re move Session 

public void removeSession (String sessionid) 
Remove a session object from the map. 
Parameters: 

sessionid - The id string for the session to remove 
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Class 

multisei^.sessk>nmgr.^essionMgrConriection 



Ob j ect 

I 

+ Thread 

I 

+ multiserv. sessionmgr . SessionMgrConnection 

public class SessionMgiConnection 

extends Thread 



CoifsPruePor ludey, 

^ mulriserv^.sessiomiigr.ScssionMgt<Ibnnecrion (Sess Socket) 
•runQ 

Cotisprucpors 

^ Sess ionMgtConnection 

public SessionMgrConnection ( SessionMgrlmpl mgr, 

Socket clientSocket ) 

M^P^ods 

•run 

public void run{) 

Overrides: 

run in class TTiread 
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Class muKiserv.sessionmgr.SessionMgrlmpl 



Object 
I 

+---RemoteObject - 

I 

+ RemoteServer 

I 

+ UnicastRemoteOb j ect 

+ 

multiserv . sessionmgr . SessionMgrlmpl 

public class SessionMgrlmpl 
extends UnicastRemoteObject 
implements SessionA4gr 

The SessionMgr remote interface is used to control the session manager. 

yariakle /ff^ex. 

♦ conFig 

Contains the application configuration information 

CoMsPrncPor iMdey^ 

^ multisen^sessionnigr.ScssionMgrImpl (String, String, String) 
Constmct a new instance of SessionMgrlmpl. 

MePfiod lftde\ 

•doseSession (String) 

Remove an existing Sessiorllmpl object from the session manager, 
• expire OldSessions O 
• finalize 0 

» initSession (Session) 

Qeate a new Sessionlmpl object within the session manager, 
• log (String) 

Write information to stdout tagged with the date and time. 
» niain (String[]) 

The main method for the session manager process. 
» notifv6erviets (int. String, Session) 
•negister(String) 

A remote entity registers interest in events taking place within the session 

manager by calling this method, 
• relond p 
•restoreStateO 
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Restores the contents of the Session map from persistent store. 
• saveState Q 

Saves the contents of the Session map to persistent store. 
• sessionldList Q 

Return an array^containing all the current Session object identifiers. 
• sessionObjName (String) 

Constructs the session object name given the session id. 
• shutdown (String) 

A remote entity informs the Session Manager that it is prepared to have 

the Manager shutdown operations. 
•shutongdowoO 
• trace (String) 
> unregister (String) 

A remote entity calls this method to stop further notifications being sent 

by the session manager. 

•config 

public multiserv. conf ig . Conf ig config 

Contains the application configuration information 

CotfsPrucPors 

>SessionMgrImpl 

public SessionMgrlmpl (String rmihost, 

String name, 

String configFile) throws RemoteException, 

Malf ormedURLException 

Construct a new instance of SessionMgrlmpl. 
Parameters: 

managerName - Identifies this session manager instance 
name - The name by which the session manager will be known 
configFile - The conf^;uration file 

•closeSession 

public void closeSession (String sessionid) throws 
RemoteException, Malf ormedURLException, NotBoundException 

Remove an existing Sessionlmpl object from the session manager. 

Parameters: 

sessionid - A string which identifies the session to be removed. 

Throws: RemoteException 

some communication problem occurred. 

Throws: NotBoundException 
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the session which is being closed does not have it's interface bound to the 
RMI registry. 
expireOldSessions 

public void expireOldSessions ( ) 
•finalize 

protected void finalize () 
Overrides: 

finalize in class Object 
•initSession 

public java. lang.String initSession ( Session initial) throws 
RemoteException, Malf ormedURLException, SessionAccessException , 
NotSerializableException 

Qeate a new Sessionlmpl object within the session manager. 

Parameters: 

session - Contains the initial session data. 
Returns: 

A string used to identify the new session in subsequent accesses to the 
session manager. 

•log 

public void log (String message) 

Write information to stdout tagged with the date and time. 
Parameters: 

message - the information to output 

9 main 

public static void main (String [] args) 

The main method for the session manager process. This installs a security 
manager as well as creating a registry so that the clients can lookup the 
manager objects. The session manager must be started with a single 
command line argurnent. This aipoment specifies the session manager 
name. 

• notifySeniets 

protected void notifyServlets (int reason, 

String sid. 
Sess ion sess) throws 

RemoteException 

•register 

public void register (String id) throws RemoteException 

A remote entity registers interest in events taking place within the session 
manager by calling this method. After this the session manager can notify 
the entity via the Servlets SessionObserver interface. 
Parameters: 
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id - A unique string identifying the registering entity. The name should be 
an RMI addressable ID. That is, you should be able to tack "rmi://" on to 
the front of it. Suggestion is "host/servletid" 
Throws: RemoteException 
if some communication failure occurs. 
• reload 

public void reload {) throws RemoteException 
•restoreState 

protected void restoreState ( ) 

Restores the contents of the Session map from persistent store. 
•saveState 

protected void saveState {) 

Saves the contents of the Session map to persistent store. 
•sessionldList 

public java.util .Vector sessionldList ( ) throws RemoteException 
Return an array containing all the current Session object identifiers. 
Returns: 

An Vector instance containing the Session object id's. 
Throws: RemoteException 
if some communication failure occurs. 
•sessionObjName 

protected java. lang . String sessionObjName (String sid) 
Constmcts the session object name given the session id. 
Parameters: 

sid - the session id string for the object 
Returns: 

a string containing the session object name or the empty string if sid is 
null, 
•shutdown 

public void shutdown {String id) throws RemoteException 

A remote entity informs the Session Manager that it is prepared to have 
the Manager shutdown operations. The Session Manager will shutdown 
operation as soon as it receives shutdown notifications from all registered 
entities. 
Parameters: 

id - A unique string identifying the entity 
Throws: RemoteException 
if some communication failure occurs, 
•shuddngdown 

public void shuttingdown ( ) 
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trace 



public void trace (String message) 
• unregister 

public void unregister (String id) throws Remote Except ion 

A remote entity calls this method to stop further notifications being sent 

by the session manager. 

Parameters: 

id - A unique string identifying the entity. 

Throws: RemoteException 

if some communication failure occurs. 

See Also: 

register 
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Class multiserv.sessionmgr.SessionMgtShiftdown 



Ob j ect 
I 

+ Thread 

I 

+ multiserv. sessionmgr . SessionMgrShutdown 

public class SessionMgrShutdown 
extends Thread 

A thread object which shuts down the SessionMgr process 

CoMsPrucPor Itide^ 

^ multisen^scssionmgr.SessionMgrShutdown O 
•runO 

CofisPrfiepors 

^ Ses s ionMgrShutxlown 

public SessionMgrShutdovm( ) 

M^Pffods 

•run 

public void run ( ) 
Overrides: 
nin in class Thread 
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Class multiservsessionmgr.SocketHandler 

Object 
I 

+ Thread 

I 

+ multiserv, sessionmgr . SocketHandler 

public class SocketHandler 
extends Thread 

A thread object which listens on a socket for connection attempts and then 
services commands from authorized clients. Normally only the host on which the 
session manager is running or the loopback device are allowed The property 
multiserv.sessionmgr.aUowedIPs of IP Addresses allows other hosts access - it 
should coonsist of white space separated IP addresses. 

CoHsPmcPor Indey^ 

^ multiser\\$cssiormigr.SockctHandler (SessionMgrImpI) 
Create a socket handler 

^eP/fod lftde\ 

.haltQ 
•runQ 

CoffsPmcPors 

^SocketHandler 

public SocketHandler ( SessionMgrlmpl mgr) 
Create a socket handler 
Parameters: 

mgr - Reference to the session manager instance 

M^P^ods 

•halt 

public void haltO 
• run 

public void run{) 
Overrides: 
run in class Thread 
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Class 

muKiserv.sessionmgr.SessionAccessException 



Object 



+ Throwable 



+ Exception 



+ 



multiserv . sessionmgr . SessionAccessException 



public class SessionAccessException 
extends Exception 

This exception is thrown to indicate a problem with accessing data within a 
session object. 



^ multiserv^sessioningr.ScssionAccessException (String) 

Constructs a new SessionAccessException with the specified descriptive 




message. 




SessionAccessException 



public SessionAccessException (String msg) 

Constmcts a new SessionAccessException with the specified descriptive 
message. 
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package multiserv.util 

inPerfaee Irtdey^ 

• Watchable 

Class Index 

• Cache 

• FileCache 

• FileCacheFactory 

• FileSuffixFilter 

• HTMLQche 

• HTN4LCacheFacton^ 

• HTMLDocument 

• Logger 

• SendMnil 

• SoundEx 

• TimedCounter 

• Watcher 

t \cepPioff Iffdex, 

• CacheException 
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Interface multiserv.util.Watchable 

public abstract interface Watchable 



•wake Up () 
•wake Up 

public abstract void wakeup ( ) 
•watch 

public abstract void watch () 
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Class muttiserv.util.Cache 



Object 

. I 

+ mult iserv . ut il . Cache 

public abstract class Cache 
extends Object 
implements Watchable 



CoMsPrucPor IndeK 



• addObject fString, Object, long) 
•getKeysQ 

Get the keys of the table rows stored in the Cache. 
• getObject (String) 
# inte rruptWatc hing 0 
• populate 0 
• reinitialize (1 
• re move Ali o 
• rg mo ve Ob jec t (String) 
• re populate (1 
• setWatc he rOe lay (long)~^ 
• startWatching fi 
• stopWatching O 

• updatcObject fString. Object, long) 
• wake up 0 
• watch Q 




•DEBUG 



^ multiscrv^utiLCache O 
^ multiserv.util.Cache (long) 




yariakles 



•DEBUG 



public static boolean DEBUG 



CoMsPriicPors 



^ Cache 
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public Cache 0 

Cache 

public Cache {long sees) 
•addObject 

public synchronized void addObject (String name, 

Object obj , 
long lastModif ied) 

•getKeys 

protected synchronized java .util . Enumeration getKeys () 
Get the keys of the table rows stored in the Cache. 
Returns: 

An Enumeration of the available keys. The keys are stored as strings. 
•getObject 

public synchronized java . lang. Object getObject (String name) 
throws CacheException 

• interruptWatching 

public void interruptWatching ( ) 
•populate 

public abstract void populate () 
•reinitialize 

public abstract void reinitialize ( ) 
•remove All 

public synchronized void removeAllO 

• rcmoveObject 

public synchronized void removeObject (String name) 

• rcpopubte 

public abstract void repopulate () 

• sctWatcherDelay 

public void setWatcherDelay ( long sees) 
•startWatching 

public void startWatching ( ) 

•stop Watching 

public void stopWatching () 
updateObject 
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public synchronized void updateObject (String name, 

Object obj , 
long lastModif ied) 

©wake up 

public final synchronized void wakeupO 
©watch 

public final synchronized void watch {) 
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Class multiserv.iftil.FiieCache 



Object 
I 

+ Cache 

I 

+ multiserv.util . FileCache 

public class FileCache 
extends Cache 



• getDoc ume nt (String) 

» main (StringQ) 

• populate 0 

# re initialize 0 

• re populate Q 

• s e tSuffixe s (StringQ) 

• getDocument 

public java.lang. String getDocument (String name) throws 

CacheException 

• main 

public static void main (String [] args) 

•populate 

public void populate () 
Overrides: 

populate in class Ciche 

• reinitialize 

public void reinitialize ( ) 
Overrides: 

reinitialize in class GKhe 
•repopulate 

public void repopulate ( ) 

Overrides: 

repopulate in class Giche 
setSuffixes 
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public void setSuf fixes (String [) fileSuf fixes) 




O 
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Class multiserv.util.RieCacheFactory 



Object 
I 

+ ^ - -multiserv . util . FileCacheFactory 

public class FileCacheFactory 

extends Object 

ConsPrucPor IndeK 

^mulriserv.utiLFileCache Factory () 

MePifod IndeK 

•getCache (String) 

♦ getCac he (String, String, long, StringQ) 

CoHspracPors 

^ FileCacheFactory 

public FileCacheFactory ( ) 

M^P^ods 

•getCache 

public static multiserv. util . FileCache getCache {String 
cacheName) throws lOException 

•getCache 

public static multiserv. util . FileCache getCache {String 
cacheName, 

String dir, 
long 

cachePeriod, 

String [] 

suffixes) throws lOException 
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Class muitiseryiiitil.RleSuffixFilter 

Object 

I 

+ multiserv.util .FileSuf f ixFilter 

public class FileSuffixFilter 

extends Object 
implements FilenameFilter 

CoMsPrucPor Ittdey^ 

^ multiscn^util.FileSuffixFilter (String[]) 
^ niultiscn^util.FilcSuffixFilter (String[]. long) 

MePffod lMde\ 

•accept(File, String) 

Cotisprucpors 

-^FileSuffixFilter 

public FileSuf f ixFilter (String [] suffixes) 
-^FileSuffixFilter 

public FileSuf f ixFilter (String [] suffixes, 

long modif iedSince) 

M^P^ods 

•accept 

public boolean accept (File dir. 

String name) 



165 



Class multiserv.util.HTMLCache 



Object 

+ Cache 

I 

+ FileCache 

I 

+ multiserv.util .HTMLCache 

public class HTMLCache 
extends FileCache 



166 




Object 
I 

+ Fi leCacheFac tory 

I 

+ mul tiserv . ut il . HTMLCacheFac tory 

public class HTMLCacheFactoiy 

extends FileCacheFactory 

CottsPrucPor ludeyt^ 

^mulrisetv>utiLHTMLCacheFactory O 

MePhod IftdeK 

»getCache (String, Strii^, long, StringQ, Hashtable) 

CofisPmcpors 

^HTMLCacheFactoiy 

public HTMLCacheFactory ( ) 

M^P^ods 

©getCache 

public static multiserv.util .HTMLCache g^tCache (String 
cacheName , 

String dir, 
long 

cachePeriod, 

String []' 

suffixes, 

Hashtable 

tokens) throws lOException 



Class multisei^.util.HT1VIIJ9ocumeirt 



Object 



+ mul t i serv . ut i 1 . HTMLDocument 



public class HTMLDocument 

extenck Object 



ConsPrMcPor iMde^ 



^mulris e rv. util. HTM L Doc ume nt fStiing, String) 
^multis c rv. util. HTML Doc ume nt (Stiing. String, Hashtable) 
^multi s c rv^ util. HTM LDoc ume nt (String. String, Hashtable, Hashtable, boolean) 



» buildListToken$ (String. String, String, Vector, Hashtable, boolean) 
» buildSimpleTokens (Hashtable. Hashtable) 

Convenience method which builds a token table to be passed to 
sendParseDocumentQ. 
•buildTokens(Ffehtable, Hashtable, boolean) 

Convenience method which builds a token table to be passed to 
sendParseDocument 0 . 
•toStnngO 





^HTMLDocument 



public HTMLDocument (String cacheName, 



String docName) throws lOException 



^HTMLDocument 



public HTMLDocument (String cacheName, 

String docName, 



Hashtable tokens) throws lOException 



^HTMLDocument 



public HTMLDocument (String cacheName, 



String docName, 
Hashtable tokens, 
Hashtable tokenData, 




boolean checkedNameVal) throws lOException 



buildListTokens 
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public static void buildListTokens (String cacheName, 

String listDocToken, 
String listDocName, 
Vector data, 
Hashtable tokens, 
boolean checkedNameVal) 

throws lOException 

• buildSimpIeToke ns 

public static void buildSimpleTokens (Hashtable data, 

Hashtable tokens) 
Convenience method which builds a token table to be passed to 
sendParseDocumentO. It basically goes through the passed Hashtable and 
builds another Hashtable where the keys are renamed as -*^key* -That is, 
' is tacked on the beginning and - is tacked on the end of each key. 
This method could be useful for taking the data from a database query 
retumed in a hashtable and building a token table to populate an HTML 
page. 

Parameters: 

data - The incoming Hashtable 

tokens - The token table to be built. It m^ht already contain some tokens 

- which will added to. 

• buildTokens 

public static void buildTokens (Hashtable data, 

Hashtable tokens, 
boolean checkedNameVal) 
Convenience' method which builds a token table to be passed to 
sendParseDocumentQ. It basicaUy goes through the passed Hashtable and 
builds another Hashtable where the keys are renamed as -^key*— That is, 
' is tacked on the beginning and '"^ - is ucked on the end of each key. 
Special cases exist for keys starting with pvt or opt. These are treated as 
the special token types for checkboxes/ radio buttons and selection lists 
respectively. This method could be useful for taking the data from a 
database query returned in a hashtable and building a token table to 
populate an HTML page. 
Parameters: 

dau - The incoming Hashtable 

tokens - The token table to be built. It might already contain some tokens 

- which will added to. 

checkedNameVal - If checked, build PVT tokens as @# name=value# @ 
else just as @# name# @ 
•toString 

public java. lang. String toString () 
Overrides: 
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toString in class Object 
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Class multiserv,util.Logger 



Object 

I 

+ Thread 

I . 

+ multiserv.util -Logger 

public class Logger 
extends Thread 

A class which can be used for logging. 

CoilsPrMCpor lude^ 

^ multi$erv^utiLLogg cr(String) 

Constructor for the Logger 

MePffod Iffdey^^ 

> getWriter O 

.main(String[]) 

•runQ 

Coftsprucpors 

^Logger 

public Logger (String logFile) throws lOException 
Constructor for the Logger 
Parameters: 

IpgFile - The file to which to log 

• getWriter 

public static java . io . PrintWriter getWriter () throws lOException 

• main 

public static void main (String [] argv) 

• mn 

public void run ( ) 

Overrides: 

run in class Thread 
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Class muKiserv.util.SendMail 



Object 



+ multiserv.util .SendMail 



pubKc class SendMail 
extends Object 
implements Runnable 

This is an interim class for sending mail. Sun hava a javamail API which is still in 
Beta Test and will be available for platform independent sending of mail. I did 
download it to check it out but it required another piece of Beta software so I 
thought I would leave it for now. 



^multis e rv\ uri l.Se ndMa il (String, String, String, String, String, String) 
^ mu Iti s e rv\ util . Se ndM a il (String, String, String, String, String, String, boolean) 





» niain (Stringn[) 
• run Q 




^SendMail 



public SendMail (String from, 



String to, 
String cc. 
String replyTo, 
String subject. 



String message) throws lOException 



^SendMail 



public SendMail (String from, 
String to, 
String cc. 



String replyTo, 
String subject. 
String message. 



boolean mimed) throws lOException 




mam 
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public static void main (String [] argv) 
run 



public void runO 
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Class muKiserv.util^undEx 



Object 

. I 

+ multiserv.util .SoundEx 

public class SoundEx 
extends Object 

ConsPfMCpor Indey^ 

^multiserv.utiLSoundEx Q 
^multiscrv.utiLSoundEx (String) 

MePffod lnde\ 

• Calculate (String) 

Generates a soundex code for the input string. 

CoffsPrtiepors 

-^SoundEx 

public SoundEx {) 

^SoundEx 

public SoundEx (String inputString) 

M^P^ods 

• Calculate 

public static java . lang . String Calculate {String inputString) 
Generates a soundex code for the input string. 
Parameters: 

inputString - The string that is used to generate the soundex code 
Returns: 

A string representing the soundex code. If a code cannot be generated 
then the string "XXXX" is returned. 
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Class multiserViUtil.Watcher 



object 

I 

+ multiserv.util .Watcher 

public class Watcher 
extends Object 
implements Runnable 

CoMSprMCpor iMdeK 

v multis e rv> util . Wa tc he r (Watchabie, long) 

/^ePffod lftdi\ 

• intcrrupt O 
•runQ 
• start Q 
•stopO 

CofiBprucPors 

^Watcher 

piiblic Watcher ( watchable babe, 
long sees) 

M^Pffods 

• interrupt 

public void interrupt.( ) 

• run 

public void run{) 
•start 

public void start ( ) 

•stop 

public void stopO 
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Object 
I 

+ Throwable 

I 

+ Exception 

+ lOExcept ion 

I 

+ multiserv.util .CacheException 

pubKc class CacheException 
extends lOException 

ConsPrdcPor iMde^ 

^ multisetv.util.CacheException Q 
^multis e r\\ uril .Cac he E xc cption (String) 
^ multisciv.util.CacheExceprion (StrLng. Exception) 

MePffod Iftde^ 

• getCausc Q 

Conspruepors 

V CacheException 

public CacheException ( ) 
, ^CacheException 

public CacheException (String reason) 

-^CacheException 

public CacheException (String reason, 

Exception e) 

M^Pffods 

•getCause 

public java . lang. Except ion getCause ( ) 
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UML Diagrams 

The following UML diagrams provide a visual description of the interactions between 
the Java classes used by Ecardfile. 

From the high level diagram you can click on the numbier by the side of the class and 
be brought to the large scale diagrarnL 
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EcardNotifier 



EolulNotifier „ 

-parent:CommonApplicationlnterface 

-myThreadiThread 

-cardld:lorig 

-eCardld:String 

-messaqeCache:Strinq 

+EcardNotifier(CommonApplicationlnterface. String, long, String){constructor} 

+run():void 

+start():void 

+interrupt( ):void 

+stop():void 

+notifyUser( Hashtable. long, long, String, Hashtable):void 



LoginServlet 
LotjinSeivlet 



init( Sen^letConfig):void 

getApplicationlnterface():Applicationlnterface 



SearchServtet 
SeaichSeivlet 



init( ServletConftg);void 

getApplicationlnterface():Applicationlnterface 
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ApplServiet 



ApplServlet 




id:String 

mgrName:String 

rmiHost: String 

sessionMgrSessionMgr 

sessionMgrState:int 

appl:Applicationlnterface 

currentRequests:int 

ourConfig:Config 

debuqOn:boolean 




init( ServletConfig):void 

doGet( HttpServletRequest. HttpServletRe 

doPost( HttpServletRequest. HttpServletR 

setSessionMgrState( int):void 

incruurreniuounn j.voia 

decrCurrentCount( ):void 

destroy():void 

getSessionMgr( ):SessionMgr 
getProperty( String): String 
log( String):void 
trace( String):void 

getApplicationlnterface():Applicationlnterf; 


sponse):void 
^sponse):void 

ice 



Ul 

Q 



lao 



SearchAppiicationlnterface 



SeiiichApplicationlnteiftice 




PUBLIC ACCESS:short 
PRfVATF ACCFf^?: <ihnrt 




SearchApplicationlnterface( ) 

init( ApplServlet, String, String):void 

destroy( ):void 

notify( SessionNotification):void 

authenticateUseit String, String. HttpServletReques 

getCookieTag( ):String 

postAuthenticate( String, Session, HttpServletRequ 
executeOperation( String, String, Session, HttpSeni 
accessDenied( String. HttpServletRequest. HttpSer 
preDestroy( String. Session, HttpServletRequest. H 
postDestroy( HttpSenHetRequest. HttpSen/letRespo 
searchUser( String, long. String, HttpServletReques 
adjustCardOetailTokens( HashtabIe):void 
newUser( String. HttpServletRequest, HttpServletRe 
validateUserForm( String. Session. String. HttpServ 
addUser( String. Session. String. HttpSen^letReque 
hashVectorFronnRowVector( StringO. Vector, short, 
addUserConfirnn( String, Session, String, HttpSenHe 
displayCardListFirstLastName( long. String. String, 
displayCardListFirstLastNanrieSoundEx( long. Strin< 
displayCard( long, String. Hashtable. int. String. Str 
displayWhereAml( long. long. Hashtable. short. Htt| 
getCards( long, String[]. boolean):Vector 
addMultiRowTokens( String, short, Vector. Hashtab 
addCardToPersonalList( DatabaseConnection2. loni 
addUserToPrivateList{ DatabaseConnection2, long, 
displayCardListPersonal( DatabaseConnection2, lor 
createCardList( DatabaseConnection2. long. Hasht< 
confirmUser( String, Session. String, HttpServletRe 
getMultiRowValuesFromForm( HttpServletRequest. 
getMultiRowVatuesFromFornn( HttpServletRequest . 
getMultiRowVa!uesFronnForni( HttpServletRequest. 
convertMu!tiRowHashes( Vector, String[]. int[]):Vec 
displayPersonalList( String, Session. HttpSenrfetRe 
displayUpdateList( String, Session. String. String. I- 
displayDownloadList( String, Session. String, HttpS 
downtoadFile( long, HttpSen^letRequest, HttpServlet 
downIoadFile( long. HttpSen^letRequest. HttpServlet 
downloadCard( long, HttpServletRequest. HttpSenHc 
sendFile( String, String, String, String. Hashtable, \ 
addPersonalList( String. Session, String, HttpSen^f 
oneTimeWelcome( String, Session, HttpServl'etReq 
delefeCTserXSlnnV/Sre's'sfon*," HlfpSeMefReque'sf ."Ff 
changeDetaits( long. Session. HttpSen^letRequest. 
doChangeDetails( String. Session, HttpServletRequ 
notifyCardSubscribers( long . String); void 
doAddWhereAnnl( long. Session. HttpServletReque< 
doChangeWhereAml( long. Session, HttpSen^tetRec 
doUpdatePlist( Stnng, Session, HttpServletRequest 
getPrivacyAccess( DatabaseConnection2, long, Ion 
getPrivacyAccess( DatabaseConnection2, long. Ion 
checkPrivacyAccess( short. Hashtable):void 
findPassword( String. HttpServletRequest. HttpSen^ 
checkToken( Vector):Vector 
checkToken( String):String 
replaceToken( String, char, String): String 
replaceToken( String, int. String):String 


):GenericSession 

3st, HttpSenrtetResponse):void 

letRequest, HttpServletResponse):void 

1etResponse):void 

tpSenrtetResponse):void 

ise):void 

:. HttpServletResponse):void 
sponse):void 

etRequest, HttpServletResponse, Hashtable): i 
>t. HttpServletResponse, Hashtable):void 
Hashtable):void 

[Request. HttpSen^letResponse, Hashtable):bt 
String. Hashtable. HttpServletResponse):boole ; 
1, String, String. Hashtable. HttpServletRespor : 
ng. HttpServletResponse):boolean 
iSen/letRequest, HttpServletResponse): boolea ' 

e, int):void 
1, long):long 
ong. short):long 

g. String. String, String, HashtabIe):boolean 

ble. String. Hashtable):boolean 

|uest. HttpServletResponse. Hashtable):void 

String ]):Vector 

String ], String): Vector 

String[ . Hashtable):void 

or 

quest, HttpServletResponse, String, Hashtabk; 
IttpServletRequest. HttpServletResponse, Has' 
ervletRequest, HttpSen^letResponse, Hashtabh 
Response, Hashtable):void 
Resporise. Hashtable. boolean):void 
tResponse, Hashtable, boolean):void 
ector, HttpSen/letResponse):void 
tRequest. HttpSen/letResponse. Hashtable):vci 
jest, HttpServletResponse. Hashtable):void 
fpSTe'rvre'tT^espo'rise* V1ashlableJ:'bo"dre"ari 
HttpServletResponse. Hashtable):void 
^s{, HttpSenHetResponse, Hashtable):boolean 

t. HttpServletResponse. Hashtable):boolean 
uest, HttpServletResponse, Hashtable):booleo 
. HttpServletResponse. Hashtable. String):boo 
3):short 

}, Hashtable):void 
etResponse): boolean 
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CommonApplicationlnterface 

CommonApplicaiionlnterfac^ 

verboseErrors: boolean 

failedlPAddresses;TfmedCounter 

htnnlCache:FileCache 

templateCache:FileCache 

wmlCache:FileCache 

lookupCache:LookupCache 

bannerCache:BannerCache 

connMgr:JdbcConnectionBroker2 

generalErrorMsg:String 

defaultPdaPage: String 

ConimonApplicationlnterface( ) 
init( ApplServlet. String, Stnng):void 
reinft( ):void 
destroy():void 

getUserlcl( HttpServletRequest): String 
getPassword( HttpServletRequest): String 
getSessionld( HttpServletRequest):String 
getCookieTag( ):String 
getCookie( HttpServletRequest): String 
addBannerToken( Hashtable):void 

sendLoginScreen( HttpServletRequest. HttpServtetResponse, String):void 
sendLoginScreen( HttpServletRequest, HttpServletResponse, String, Hashtable):void 
sendSearchScreen( HttpServletRequest. HttpServletResponse, String, Hashtable):void 
sendSearchScreen( HttpServletRequest, HttpServletResponse. String):void 
sendSearchScreen( HttpServletRequest, HttpSenHetResponse):void 
operationRequiresLogin( String):bootean 
isLoggedln( String, Session):boolean 

accessDenied( String, HttpSenrietRequest. HttpServletResponse):void 
checkAccess( HttpServletRequest): boolean 
sessionFaiture( String, HttpSen/letRequest):boolean 
locklP( String):long 
initLockedlPaddresses( int):void 

validateSession( String, Session. HttpServletRequest): boolean 
getOperation( HttpServletRequest): String 
. hiddenFie!d( String, String):String 
getFullPath( String):String 
sendDocument( String. HttpServletResponse):void 
sendParseDocument( Hashtable. String. HttpServletResponse):void 
sendParseDocument( Hashtable. String. String. HttpServletResponse):vaid 
sendParseTextFile( Hashtable. String. String, HttpSenHetResponse):void 
sendParseTextFile( String. String. Hashtable, String, String. HttpServletResponse):void 
sendParseTextFile( String, Hashtable. String, String. HttpServletResponse):void 
checkPrrvacyAccess( DatabaseConnection2. long. long. Hashtable):short 
cardDownloadUri( Hashtable):void 

sendEn'or( HttpServletRequest, String, String, HttpServletResponse):void 
sendError( String. String. String, HttpServletResponse):void 
sendError( Hashtable, String, String. HttpServtetResponse):void 
sendError( Hashtable. String. String, String, HttpServletResponse):void 
sendMessage( String. String. HttpServletResponse):void 
sendMessage( Siring. Hashtable, String, HttpServletResponse):void 
sendMessage( String, String, Hashtable, String, HttpServletResponse):void 
unknownOperalion( HttpServletRequest. HttpServletResponse):void 
db_error( HttpServletRequest. HttpServletResponse):void 
db_error( HttpServletRequest. HttpSenvletResponse. String):void 
nfe_error( HttpServletRequest. HttpServletResponse):void 
nfe_error( HttpServletRequest. HttpServletResponse. String):void 
sae_error( HttpServletRequest, HttpServletResponse);void 
re_error( HttpSenHetRequest, HttpServletResponse):void 
doc_access_error( HttpServletRequest, HttpServletResponse):void 
io_error( HttpSenHetRequest. HttpServletResponse):void 
nse_error( HttpServletRequest. HttpSen^etResponse);void 
verboseError( String):String 

getSenvletlnngBtnParameter( HttpServletRequest): String 
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LoginApplicationlnterface 

t 1 

LoginApplicationlnterface 



LoginApplicationlnterface( ) 

init( ApplServlet, String. String):void 

notify( SessionNotification):void 

authenticateUseit String. String. HttpSeivletRequest):GenericSession 
getCookieTag():String 

postAuthenticate( String. Session, HttpSewletRequest. HttpSen^letResponse):void 
executeOperation( String, String. Session. HttpServletRequest, HttpServletResponse):void 
accessDenied( String. HttpSenHetRequest, HttpSenHetResponse):void 
preDestroy( String. Session, HttpSenHetRequest. HttpServletResponse):void 
postDestroy( HttpServletRequest. HttpServletResponse):void 
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Applicationlnterface 



Applicationlnierfkice 

servletiApplServlet 

ourTimeZone.'TimeZone 

ApplicationlnterfaceO 

4nrt( ApplSefvlet-; -String- ^Wng):wid 

destroy():void 
getProperty( String); String 
getTimeZone( ):TimeZone 
trace( String):void 
log( String);void 

notify( SessionNotification):void 

chainRequest( String, HttpServletRequest. HttpServletResponse):void 
getSen(letParameter( HttpServletRequest, String): Stririg 
getServletParameterValues( HttpSen^letRequest, String):String[] 
getUserld( HttpSen/letRequest):String 
getPassword( HttpServletRequest):String 

authenticateUser( String, String, HttpSenr!etRequest):GenericSession 
getSessionld( HttpSen^letRequest):String 

accessDenied( String. HttpServletRequest, HttpServletResponse):void 
postAuthenticate( String, Session, HttpServletRequest, HttpSen/letResponse):void 
getOperation{ HttpSen/letRequest):String 
checkAccess( HttpSen/letRequest):boolean 
sessionFailure( String, HttpSen/letRequest):boolean 
vaiidateSession( String, Session, HttpServletRequest):boolean 

executeOperation( String. String, Session, HttpServletRequest, HttpSen/letResponse):void 

preDestroy( String, Session, HttpServletRequest. HttpServletResponse):void 

postDestroy( HttpServletRequest, HttpServletResponse):void 

sendError( HttpSen/letRequest. String, String, HttpServletResponse):void 

unknownOperation( HttpSen/letRequest. HttpSen/letResponse):void 

db_error( HttpServletRequest, HttpServletResponse):void 

db_error( HttpServletRequest, HttpServletResponse. String):void 

nfe_error( HttpServletRequest. HttpSenvletResponse):void 

nfe_error( HttpSen/letRequest. HttpSenvletResponse, String):void 

sae_error( HttpSen/letRequest. HttpSenvletResponse):void 

re_error( HttpServletRequest, HttpSenvletResponse):yoid 

doc_access_error( HttpSen/letRequest, HttpSen/letResponse):void 

io_error( HttpSen/letRequest. HttpSen/letResponse):void 

nse_error( HttpSen/letRequest. HttpSen/letResponse):void 
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DatabaseConnection2 



0<iuib«iseConnection2 



szClass:String 

DEBUG:boolean 

userUser 

addressiAddress 

emaN:Email 

phone:Phone 

personalList:PersonalList 

privateList:PrivateList 

wh e re Am I : Wh e re Am I 

lookup:Lookup 

lockedlPiLockedIP 

bannerBanner 

szClassMelhod:Strinq 



DatabaseConnection2( ) 

DatabaseConnection2( String. String. String) 

getlnstance( String. String. String):JdbcConnection 

lnitialize():void 

close():void 

User():User 



Address 



Add I ess 



S2Class:String 

table:String 

columnNames:String[] 

columnLength:int[] 

columnTypes:int[J 

psByUserldiPreparedStatement 

Address( Connection) 



Banner 



szClass:String 

table:String 

columnNames:String[) 

columnLength:int[) 

columnTypesiintfl 



Banner( Connection) 
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UsefObtect 

Us^iObject 

szClass:String 

psByUserld:PreparedStatement 

psDeleteByUserldiPreparedStatement 

UserObject( Connection. String. String[], int[]. int[]) 

QueryByUserld( long):Vector 

QueryByUserld( int):Vector 

Insei1( long, String[|):long 

Update( long, String[]):long 

DeleteByUserld( long):long 



WhefeAml 

WhereAml 

szClass:String 
table:String 

' columnNames:String[] 
columnLength:int[] 
columnTypes;int[] 

psByUserldWithDate:PreparedStatement 

psBvExpirv:PreparedStatement 

WhereAml( Connection) 
GetWithDate( long):Hashtable 
QueryByExpiry( long, String):Vector 
Update{ long, String[]):long 
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0 



0 



Onscctiveyser 

InactivelJser 

szClass:String 

table;String 

columnNames:String[] 

columnLength:int[J 

columnTypes:int[] 

psByECardldAndSessionld:PreparedStatement 

psBvECardld:PreparedStatement 

lnactiveUser( Connection) 
Get( String. String):Hashtable 
Get(String):Hashtable 
. Insert( InactiveDatabaseConnection. Stringf), Vector/Vector, Vector):long 
Update( InactiveDatabaseConnection, Stringd, Vector, Vector. Vector):long 
Delete( InactiveDatabaseConnection, long):int 



User 

User 

szClass:String 

table:String 

colunrinNames:String[] 

columnLength:int[] 

colunnnTypes:int[] 

psByECardId: PreparedStatement 

psByFirstLastNanne: PreparedStatement 

psByFirstLastNameSoundEx:PreparedStatement 

psByFirstNanne: PreparedStatement 

psByLastName: PreparedStatement 

psByLastNameSoundEx:PreparedStatement 

psByECardldPassword:PreparedStatement 

csConfirmUserCallableStatement 

MAX ROWS:int 

User( Connection) 

Get(String):Hashtable 

GetForLogin( String. String):Hashtable 

QueryByFirstLastName( String. String):Vector 

QueryByFirstLastNameSoundEx( String, String):Vector 

lnsert( DatabaseConnection2, String[]. Vector. Vector, Vector):long 

Update( DatabaseConnection2, String[], Vector, Vector, Vector):long 

Delete( DatabaseConnection2, long):int 

ConfirmUser( String, Stnng):int 



Phone 



Phone 

szClass:String 

table:String 

columnNames:String[] 

columnLength;int[] 

columnTypesiintf] 

Phone( Connection) 



Usertnfo 

User Info 

szClass:String 

table:String 

coiumnNames:String[] 

colunanLength:int(] 

columnTypes:int[] 

psByCategory: PreparedStatement 

Userlnfo( Connection) 

QueryByCategory( long, short):Vector 

Update( long, Vector):long 



BannerCache 

BiinnerCoche 

cacheKeys:Vector 

randomness: Randonn 

BannerCache( JdbcConnectionBroker2, long) 
BannerCache( ) 

getJdbcObject( Connection); JdbcObject 

populate():void 

getRandonnAd( ): String 



EMail 

Email - 

S2Class:String 

table:String 

columnNannes:String[] 

colunnnLength:int[l 

columnTypes:int[l 

Email( Connection) 
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InactiveAddress 



InacfiveAddfess 

szClass:String 

table: String 

columnNames:String[] 

columnLength:int[] 

columnTypes:int[J 

psByUserldiPreparedStatement 

lnactiveAddress( Connection) 



InactiveDatabaseCoimection 

InactivePatabaseConnection 

S2Class:String 

DEBUG:boolean 

connect:Connection 

userlnactiveUser 

address: InactiveAddress 

ennaihInactiveEnriail 

phone:lnactivePhone 

lnactiveDatabaseConnection( Connection) 
lnactiveUser( ):lnactiveUser 
lnactiveAddress(): InactiveAddress 
lnactiveEmail( ):lnactiveEmail 
lnactivePhone( ):lnactivePhone 



InactivePhone 

InacfivePhone 

szClass: String 
table:String 
columnNames:String[] 
columnLength:int[] 

columnTvpes:int[] 

lnactivePhone( Connection) 



Lookup 

Lookup 

szClass:String 

table:String 

columnNanaes:String[] 

columnLength:int[] 

columnTvpes:int[1 

Lookup( Connection) 



InactiveEmafl 



InactiveEmaii 

szClass:String 
table:String 
, columnNames:String[] 
columnLength:int[] 

columnTvpes:int[] 

lnactiveEmail( Connection) 



LdckedlP 

LockedIP 

szClass:String 
table; String 
columnNames:String[] 
columnLength:int(] 
columnTypes:int[] 
' psAlhPreparedStatement ' 
LockedlP( Connection) 
Query All( ): Vector 



LookupCache 

LookiipCiiche 

byCategory:Hashtable 
ADDRESSiShort 
PHONE: Short 
EMAIL: Short 

USERINFO:Short ■ 

LookupCache( JdbcConnectionBroker2. long) 
LookupCacheO 

getJdbcObject( Connection):JdbcObject 
populate():void 

addLookupTokens( Short. Hashtable):void 
replaceLookupTokens( Short, String, int, Hashtable):void 
addVcardTokens( Short. Hashtable):void 
replaceVcardTokens( Short, String, int, Hashtable):void 
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Personal List 



Person<ilList 



szClass:String 

table;String 

columnNames:String[] 

columnLength:int[] 

columnTypes:int(] 

psIsCardThere: PreparedStatement 

psJoinByUsersld:PreparedStatement 

psContainsCard: PreparedStatement 

psJoinByUsersldName: PreparedStatement 

psDeleteByCardld: PreparedStatement 



PersonalList( Connection) 
lsCardThere( long, long):boolean 
QueryJoinByUserld( long):Vector 
QueryContainsCard( long);Vector 
QueryJoinByUser|dName( long, char):Vector 
lnsert( DatabaseConnection2, long, long, long, short):long 
DeleteByUserld( DatabaseConnection2, long);int 
DeleteByCardld( DatabaseConnection2. long):int 
Delete( DatabaseConnection2. long, long):int 



PrivateUst 



PriViiteList 



szClassiString 

table:String 

columnNames:String[] 

columnLength:int[] 

columnTypes:int[] 

psGetMask: PreparedStatement 

psUpdateMask: PreparedStatement 

psDeleteByCardld: PreparedStatement 



PrivateList( Connection) 
Get(long, long):Hashtable 
UpdateMasl<( long, short):long 
DeleteByCardld( long):long 
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THIS PAGE BLAM^ 



Time<ICoimter ' 

counters:Hashtable 
period:long 

maxCount:int 

TimedCounter( long, int) 
increment( Object): int 
checkMaxCount( Object):boolean 
getCount( Object): int 
setCount( Object, int):int 
main( String[l):void 



Timed Item 

Timedltem 

timeoutTinne:long 

cQunt:int 

TimedltemO 
Timedltem( int) 
increment():int 
^ getCount():int 
setCount( int):int 
reset():void 



Timing 

TiniiiHj 

start:long 

TimingO 

LogTiming( String);void 



Logger 

Lo5j(jei 

nnyLQgFile:String 
myWriterPrintWriter 

pin:PipedReader 

Logger( String) 
run():void 

getWriter():PrintWriter 
main( String):void 



Config 

Confi<j 



Config( String) 
Config( Properties, String) 
■ loadConfig( String):void 
main( String):void 



Config Exception 

ConfitjException 

cause:Exception 

ConfigException() 
ConfigException( String) 
ConfigException( Exception) 
ConfigException( String, Exception) 
getCause():Exception 



vfdbcObfect 

JdbcObject 

szClass:String 

table:String 

columnNames: String!] 

colunanLength:int[] 

colum.nTypes:int[] 

DEBUG:boolean 

COLUMNS:int 

COLUMNSJNSERT:int 

VALUES: int 

UPDATES; int 

INSERTS: int 

ps:PreparedStatement 

psByld:PreparedStatement 

pslnsert:PreparedStatement 

psUpdate:PreparedStatement 

psUpdateCheck:PreparedStatement 

psDelete:PreparedStatement 

psMaxld:PreparedStatennent 

psAILPreparedStatennent 

connect:Connection 

JdbcObject( Connection. String. String[j, int[]. int[]) 

Get( long):Hashtable 

Get():Hashtable 

Query():Vector 

QueryAII():Vector 

lnsert( String[]):long 

Update(long, String[]):long 

UpdateCheck( long, long. String[]):long 

UpdateRow( String[]):long 

Delete( long):long 

Execute():long 

getNextld():long 

getRow(ResultSet, ResultSetMetaData. int):Hashtable 
getColumnNames( ):String[] 
getColumnTypes():int[] 
getColumnString( int):String 
TableNanne(): String 
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JdbcConnection 



J<lbcConnection 

debugiboolean 

connectiConnection 

JdbcConnectionO 

JdbcConnection( String, String. String) 
lnitialize():void 

getlnstance( String, String. String):JdbcConnection 
Connect( String. String, String):boolean 
isClosed():boolean 
close():void 

getConnection( ):Connection 
getWarnings( ):SQLWarning 
clearWarnings():void 
createStatennent( ):Statement 
toString():String 



JdbcConnection Factory 

JdbcConnectionFacTofy 

dummyConnection: JdbcConnection 
URLString 
username:String 

password: String 

JdbcConnectionFactory( JdbcConnection, String, String, String) 
getConnection( ):JdbcConnection 



JdbcVendor 

JdbcVentloi 

SUPPORTJD:boolean 
DUP^VALUE:int 

PUP INDEX:int 

getld( PreparedStatement):long 
setLockModeWait( Connection, int):boolean 
knownError( SQLException):boolean 
duplicatelndex( SQLException):boolean 



FiteSuffixFitter 

FileSuffixFiltet 

suffixes:String 

modifiedSinceilong 

FileSuffixFilter( String) 
FileSuffixFilter( String, long) 
accept( File, String):boolean 
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SoundEx 

SoimdEx 

originalString; String 
soundExCodesiHashtable 
AreCodesSet: boolean 
SoundEx() 
SoundEx( String) 
Calculate^ String): String 
isVaiid( String):boolean 
collapse( String): String 
setupCodes( ):void 
getSoundCode( char):short 



CacheException 

CilcheException 

cause:Exception. 

CacheException() 
CacheException( String) 
CacheException( String, Exception) 
getCause( ):Exception 



JdbcException 

J<lbcException 



JdbcException( ) 
JdbcException( String) 
JdbcException( String, String, int) 
isDuplicateValue( ):boolean 



SendMan 

SendMiiil 

thread:Thread 

process:Prdcess 

mailWriterPrintWriter 

from: String 

to:String 

cc:String 

replyTo: String 

subject:String 

nnessage:String 

nnimed:boolean 

SendMail( String. Stnng, String, String, String, String) 
SendMail( String, String. String, String, String, String, boolean) 
run():void 

quotedPrintableEncoding( String): String 
nnain( String):void 
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SessconTabSe 
SessionTiible 



getSession( String):Session 
putSession( Session. String):void 



- 2 

ApplSeiviet 

id:String 
mgrName: String 
. rmlHost: String 
sessionMgrSessionMgr 
sessionMgrState:int 
apphApplicationlnterface 
currentRequestsiint 
ourConftg:Config 

debuqOn:boolean 

init( Sen^lelConfig):void 

doGet( HttpServletRequest, HttpSer^letResponse):void 

doPost( HttpServletRequest, HttpSen^letResponse):void 

setSessionMgrState( int):void 

incrCurrentCount( ):void 

decrCurrentCount( ):void 

destroy():void 

getSessionMgr( );SessionMgr 
getProperty( String): String 
log( String):void 
trace( String):void • 

getApplicationlnterface():Applicationlnterface 



FileCacheFactoTy 

FileCkicheFiicfory 

myCaches:Hashtable _ 

getCache( String. String, long, String[]):FileCache 
getCache( String):FileCache 
retrieveDocunnent( String, String): String 



HTMLCacheFactOTy 

HTMLCiicheFc^ctory 



getCache( String, String, long, String[], Hashtable):HTMLCache 
retrieveDocument( String, String):String 



ReqtiestHandler 

Re<|iiestHan<llei 

CREATE: String 
DESTROY:String 
rmiHost: String 
managerName: String 
servlet:ApplSenHet 
appllnterface:Applicationlnterface 
operation: String 
request:HttpSer^etRequest 

response:HttpSeryletResponse 

RequestHandler( String. String, ApplServlet, Applicationlnterface. HttpServletRequest. HttpSer^etResponse) 
handle():void 

sessionMgr( ):SessionMgr 
sessionObjName( String):String 
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o 



o 



ApplicaYionlnterface 

servlet:ApplServlet 

ourTimeZoneTimeZone , 

ApplicationlnterfaceO 

init( ApplServlet. String. String):void 

destroy( ):voicl 

getProperty( String):String 

getTimeZone( ):TimeZone 

trace( String):void 

log( String):void 

notify( SessionNotification):void 
. chainRequest( String, HttpSen/letRequest. HttpSen^letResponse):vbid 
getServletParameter( HttpSen^letRequest. String): String 
getServletParanneterValues( HttpSen^letRequest, String); String[ J 
getUserld(HttpServletRequest):String 
getPassword( HttpServletRequest):String 

authenticateUser( String. String. HttpSen^letRequest):GenericSession 
getSessionld( HttpServletRaquest): String 

accessDenied( String, HttpSen/letRequest. HttpSen^letResponse):void 
postAuthenticate( String, Session. HttpSen^letRequest. HttpServletResponse):void 
getOperation( HttpServletRequest): String 
checkAccess( HttpSen^IetRequest):boolean 
sessionFailure( String, HttpServletRequest):boo!ean 
validateSession( String. Session. HttpSen(letRequest):boolean 

executeOperation( String. String, Session. HttpServletRequest. HttpSen/letResponse):void 

preDestroy( String. Session, HttpServletRequest. HttpServletResponse):void 

postDestroy( HttpSen^letRequest. HttpServletResponse):void 

sendError( HttpSen/fletRequest. String. String, HttpSen^letResponse):void 

unknownOperation( HttpSen^letRequest, HttpSen^letResponse);void 

db_error( HttpServletRequest. HttpSen^letResponse):void 

db_error( HttpServletRequest, HttpSen^letResponse, String);void 

nfe_error( HttpServletRequest. HttpSen^letResponse):void 

nfe_error( HttpServletRequest, HttpServletResponse, String):void 

sae_error( HttpSen^letRequest. HttpSen^letResponse):void 

re_error( HttpServletRequest. HttpSen^letResponse):void 

doc_access_error( HttpServletRequest, HttpSen^!etResponse):void 

io_error( HttpServletRequest. HttpServletResponse):void 

nse_error( HttpServletRequest, HttpSen/letResponse):void 
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TaUeCache 



TableCache 

connMgr:JdbcConnectionBroker2 
TableCacheO 

TableCache( JclbcConnectionBroker2) 

TableCache{ JdbcConnec.tionBroker2. long) 

setConnManager( JdbcConnectionBroker2);void 

getJdbcObject( Connection): JdbcObject 

populate():void 

getRow( long):Hashtable 

repopulate():void 

reinitialize():void 



Watchable 

\WaXch3hTe 



; watch( ):void \ 
; wakeup{):void\ 

' r- 

Cache 

Cache 

cache:Hashtable 
cacheWatcher: Watcher 
watcherDelay:long 

DEBUG:boolean 

CacheO 

Cache( long) 

populate():void 

repopulate():void 

reinitiali2e():void 

watch():void 

wakeup():void 

createWatcher( long):void 

startWatching():void 

stopWatching():void 

interruptWatching( );void 

setWatcherDelay( long):void 

getObject{ String): Object 

getKeys( ): Enumeration 

addObject( String, Object. long):void 

removeObject( String):void 

removeAII( ):void 

updateObject(. String. Object. long):void 
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JdbcConnectionBrokeff2 



J<lbcConne€tionBiok«r2 

runnerThread 

connFactory;JdbcConnectionFactory 

connPool:JdbcConnection[] 

connStatus:(nt(J 

now:java.utiLDate 

connLockTime:long[] 

connCreateDate:long[] 

connID:String() 

dbDriver: String 

logFileString:String 

currConnections:int 

connLast:int 

minConns:int 

maxConns:int 

maxConnMSec:int 

log:PrintWriter 

currSQLWaming:SQLWarning 

randomness:Random 

JdbcConnectionBroker2( String, String. String. String, JdbcConnection, int, int. String, double) 

run():void 

interrupt( ):void 

getConnection( ):JdbcConnection 
idOfConnection( JdbcConnection):int 
freeConnection( JdbcConnection): String 
getAge( JdbcConnection):long 
createConn( PrintWriter. int):void 
release():void 
destroy( ):void 



HT MLCache 

HTMLCache 

tokens:Hashtable 

HTMLCache( String, long, String, Hashtable) 
getFileContents( File): String 
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HTMLDocumectt 

HTMLDocumenT 

theDocument:String 

myCache:FileCache 

NO_TOKEN:int 

STARTING_TOKEN:int 

IN_TOKEN:int 

ENDING_TOKEN:int 

COMPLETE_TOKEN:int 

REJECT_TOKEN:int 

LIST JYPE: char 

OPTION^TYPE:char 

BUTTON_TYPE;char 

BASIC_TYPE:char 

TOKEN MATE:char 

HTMLDocument( String. String) 

HTMLDocument( String. String. Hashtable) 

HTMLDocument( String, String, Hashtable. Hashtable. boolean) 

toString():String 

retrieveDocument( String, String, Hashtable);String 
parseDocument( Hashtable. String, boolean):String 
parseDocument( Hashtable. String): String 
replaceToken( StringBuffer, String. Hashtable. boolean):voicl 
buildTokens( Hashtable, Hashtable. boolean):void 
. buildSimpleTokens( Hashtable. Hashtable):void 
buildListTokens( String, String, String. Vector. Hashtable. boolean):void 



Watcher 

I 1 

Wcitcher 

myThread:Thread 

myTimeout:long 

babe:Watchable 

isRunninq:boolean 

Watcher( Watchable. long) 
run():void 
, start():void 
interrupt( );void 
stop():void 
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FUeCache 

dirName: String 
cacheDirFile 

suffixes: String 

FileCache( String) 
FileCache( String, long) 
FileCache( String, long, String) 
setCacheDirectory( String):void 
getDocument( String): String 
populate():void 
repopulate( ):void 
' getFileContents( File):String 
reinitialize():void 
setSuffixes( String):void 
main( String[]):void 



CacheObject 

CachedObject 

lastModified:long 

Qbi:Qbiect 

CachedObject( Object, long) 
setObject( Object):void 
setLastModified( long):void 
getObject():Object 
getLastModified( ):long 
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